dotnet core 编程规范 花括号空格字段限定访问命名空间空行多余空格参照现有明显的类型关键字常量命名变量名字符串字段结构其他字符Label
dotnet core 编程规范 花括号空格字段限定访问命名空间空行多余空格参照现有明显的类型关键字常量命名变量名字符串字段结构其他字符Label
本文实际只是翻译 .NET Core foundational libraries 官方文档的编码风格。
在 .NET Core foundational libraries项目使用的编程规范默认就是 VisualStudio 默认样式。
花括号
花括号使用 Allman style 风格，所有的花括号在新的一行开始。
关于 Allman style 就是如下，花括号放在下一行，而且花括号不进行缩进，花括号里面的代码缩进。
while (x == y)
{
something();
somethingelse();
}但是对于单行的语句，可以不添加花括号，但是请把它放在同一行
if (xx == null) xx = new Foo();单行语句同样建议添加花括号避免苹果的bug
如果不添加花括号，一定不要在嵌套时使用。
空格
使用 4 个空格作为一个缩进，而不是使用 tab
字段
所有的字段使用_camelCase风格，而且尽可能使用readonly 。在 internal 和 private 访问的字段添加 _ 前缀，对于静态的字段添加s_前缀，对于线程静态的字段添加t_前缀。如果使用了静态的字段而且可以设置readonly ，需要把readonly 放在static后面。
最好不要公开字段，如果需要公开那么使用PascalCasing风格而且不添加前缀。
我不是很赞同对字段的风格，但是因为本文是翻译，我就没有添加自己的理解。
限定
不要添加 this. ，完全是没必要的。
我也不是很赞同这个，因为如果使用扩展方法，需要使用this.
访问
显示指定访问，即使访问是默认的，如private string _foo ，而不是string _foo。访问需要放在最前面，如public abstract，不建议abstract public
默认的访问是可能修改的
命名空间
对于引用需要放在文件的开头。
空行
禁止超过一行的空白，不可以使用两行空白。
不要使用两行分割两个类型。
多余空格
禁止在一行结束添加多余空格。通过 VisualStudio 的查看空格(ctrl+E,S)可以看到空格
参照现有
如果一个文件在格式规范定义之前已经有自己的规范，尽可能参照文件现有的规范而不是去修改他。
新的修改参照现有的文件的格式。
我一点都不赞同。
明显的类型
只能在明显可以知道对象类型可以使用 var ，如var stream = new FileStream(...) 。在无法明显知道对象类型不可以使用 var ，如var stream = OpenStandardInput() 。
关键字
使用语言的关键字代替 BCL 类型，如使用 int, string, float代替Int32，String，Single
常量命名
对于所有的常量，包括静态只读，使用 PascalCasing 风格。如果需要使用 C++ 或其他代码对于命名有要求才可以使用其他的方法。
变量名字符串
如果使用变量名的常量，必须使用 nameof 关键字。
字段结构
字段必须放在一个类声明的最前面。
我一点都不赞成，因为谁会去管一个类的字段，我关心的是构造函数和公开属性、函数。
其他字符
如果在代码使用了 非 ascii 的字符，那么需要把他转换为 \uxx 方式，这样可以解决一些非 ascii 因为编译器分析的问题。
当然上面的要求只是对于编译的代码
Label
使用 Label 缩进一个小于当前缩进的标签
本文会经常更新，请阅读原文： https://lindexi.gitee.io/post/dotnet-core-%E7%BC%96%E7%A8%8B%E8%A7%84%E8%8C%83.html ，以避免陈旧错误知识的误导，同时有更好的阅读