|
|
@@ -10,6 +10,15 @@
|
|
|
- 修改已有代码时优先保持最小改动,并删除修改后确定无用的内容。
|
|
|
- 不添加只有一两行的小型辅助方法;仅有一个引用的方法或变量应积极考虑内联。
|
|
|
|
|
|
+## C# 代码风格
|
|
|
+
|
|
|
+- 大括号不换行;变量名使用小驼峰,类型、属性和方法名使用大驼峰。
|
|
|
+- 没有 `else`、逻辑较短且仅含一条语句的 `if` 写在一行并省略大括号,例如 `if (flag) break;`;`if` 一旦换行,必须添加大括号。
|
|
|
+- 单行大括号内的内容前后不加空格,例如 `{element}`。
|
|
|
+- 行尾注释与代码之间、`//` 与注释正文之间各留一个空格,例如 `break; // 注释`。XML 文档注释引用参数时使用 `<paramref name="..."/>`。
|
|
|
+- 优先使用 C# 13 下更简洁且清晰的写法,例如 using 声明、本地函数和集合表达式。
|
|
|
+- 使用 `""` 表示空字符串,不使用 `string.Empty`。
|
|
|
+
|
|
|
## 项目边界
|
|
|
|
|
|
- `Shared` 只存放可跨产品复用的通用能力,不得依赖具体上层应用的业务领域或 UI 页面。
|