命名规范 (详解)

的第一个单词。
System.IO public void StartIO(Stream ioStream)
√ 要把由三个或三个以上字母组成的首字母缩写词的第一个字母大写。只有第一 个字母大写，除非首字母缩写词是 camelCasing 风格的标识符的第一个单词。
System.Xml public void ProcessHtmlTag(string htmlTag) × 不要把 camelCasing 风格的标识符头部的任何首字母缩写词的任何字母大写，
对框架中标识符的名字来说，很重要的一点是要一目了然。标识符的名字应该清 楚地说明每个成员做什么，以及每个类型和参数表示什么。为此，名字的意思清 楚要比长度短更重要。名字应该与场景、系统的逻辑组成或物理组成以及为人熟
知的概念相对应，而不应该与技术或架构相对应。 √ 要为标识符选择易于阅读的名字。
例如，一个命为 HorizontalAlignment 的属性就比 AlignmentHorizontal 更易于阅 读。
Not Bitflag CallBack Cancelled Dont EMail EndPoint Filename GridLine HashTable ID Indices LogOut LogIn MetaData, metaData MultiPanel MultiView NameSpace OK PI PlaceHolder SignOn SignOff Username Whitespace Writeable
C++
CLR
sbyte
SByte
char
SByte
byte
Byte
unsigned char
Byte
short
Short
short
Int16
ushort
UInt16
unsigned short
UInt16
int
Integer
int
Int32
uint
UInt32
unsigned int
UInt32
long
么会使类型、成员以及参数的标识符更易于阅读。
1.1 标 志 符 的 大 小 写 规 则
为了区分一个标识符中的多个单词，把标识符中的每个单词的首字母大写。不要
用下划线来区分单词，或者在标识符中的任何地方使用下划线。有两种合适的方
法来大写标识符中的字母，这取决于所使用的标识符：
PascalCasing camelCasing PascalCasing 约定被用于除了参数名之外的所有标识符，它把标识符中每个单 词的首字母（包括长度为两个字符以上的首字母缩写词）大写，如下面的例子所
字母缩写词遵循与任何其他单词一样的规范。只有第一个字母大写，除非是
camelCasing 风格的参数名中的第一个单词，在这种情况下第一个单词全部小
写。
正如前面一节已经提到的，对两个字母组成的首字母缩写词（例如 IO）的处理
是不同的，其主要目的是为了避免混淆。这样的首字母缩写词的两个字母都应该
大写，除非是 camelCasing 风格的参数名中的第一个单词，在这种情况下两个
有两个常用的其他术语，它们本身属于另一个类别，因为它们是俚语性质的常用 缩写。这两个单词是 Ok 和 Id（它们的大小写应该如所显示的那样），虽然前面
的规范说过名字中不应该使用缩写，但它们是例外。
1.4 是 否 区 分 大 小 写
虽然运行于 CLR 之上的一些编程语言的确区分大小写，但这并不是必需的。即 使你使用的语言区分大小写，可能会使用框架的其他语言却并不一定会区分。因 此，任何外部可访问的 API 不应该仅通过大小写来区分位于同一个上下文中的
架的标识符中使用它们仍是不好的做法
2.3 避 免 使 用 语 言 特 有 的 名 字
对那些所谓的基本类型，CLR 平台上的编程语言通常都有自己的名字（别名）
来称呼它们。例如，int 是 C#中 System.Int32 的别名。为了确保框架能够充分
利用跨语言协作——CLR 的核心特性之一，避免在标识符中使用语言特有的类
Long
__int64
Int64
ulong
UInt64
unsigned __int64 UInt64
float
Single
float
Single
double
Double
double
无论首字母缩写词的长度是多少。
1.3 复 合 词 和 常 用 术 语 的 大 小 写
在涉及大小写时，大多数复合词术语要作为单个单词处理。 × 不要把所谓闭合形式的复合词中每个单词的首字母大写。 这些复合词要写成一个单词，比如 endpoint。为了统一大小写规范，我们把闭合 形式的复合词作为一个单词处理。如果想知道一个复合词是否应该以闭合形式来
型名是重要的。
√ 要给类型名使用语义上有意义的名字，而不要使用语言特有的关键字。
例如，GetLength 这个名字比 GetIn，而不要使用语言特有的别名——如果除了类型之
外，标识符没有其他的语义。
例如，一个把类型转换为 System.Int64 的方法应该被命名为 ToInt64，而不是
√ 要更看重可读性，而不是更看重简短性。属性名 CanScrollHorizontally 要胜过 ScrollableX（不太明显地引用到了 X 坐标轴）。
× 不要使用下划线、连字符以及其他任何既非字母也非数字的字符。 × 不要使用匈牙利命名法。
× 避免使用与广泛使用的编程语言的关键字有冲突的标识符。 根据 CLS（公共语言规范）的第 4 条规则，所有符合规范的语言必须提供一种 机制，允许用户访问以该语言的关键字来命名的标识符。例如，C#在这种情况 下使用@符号作为转义机制（escape mechanism）。但是，由于在使用方法时， 用转义序列（escape sequence）要比不用转义序列麻烦得多，因此避免使用常
√ 不要使用缩写词和缩约词作为标识符名字的一部分。例如，要用 GetWindow， 而不要用 GetWin。
√ 不要使用未被广泛接受的首字母缩写词，即使是被广泛接受的首字母缩写词， 也只应该在必需的时候才使用。
例如，UI 用来表示 User Interface，HTML 用来表示 Hypertext Markup Language。 虽然许多框架设计师认为一些新近的首字母缩写词很快就会被广泛接受，但在框
属性
Pascal
事件
Pascal
字段（静态）
Pascal
枚举值
Pascal
参数
Camel
public class StreamReader { … } public interface IEnumerable { … } public class Object { public virtual string ToString(); } public class String { public int Length { get; } } public class Process { public event EventHandler Exited; } public MessageQueue { public static readonly TimeSpan InfiniteTimeout; } FileMode { Append, … } public class Convert { public static int ToInt32(string value); }
示：
PropertyDescriptor HtmlTag
两个字母长的首字母缩写词是一个特例，在这种情况下两个字母都要大写，如下
面的标识符所示：
IOStream camelCasing 约定仅用于参数的名字，它把标识符中除了第一个单词之外的所有 单词的首字母大写，如下面的例子所示。在例子中，如果 camelCasing 风格的
ToLong（因为 System.Int64 是 CLR 类型名，它对应于 C#特有的别名 long）。
表 3-3 列出了有别名的基本类型在 CLR 中的类型名（以及与 C#、Visual Basic、
C++相对应的类型名）
表 3-3 语言特有的类型名及对应的 CLR 类型名
C#
Visual Basic
两个名字。 实际上是否区分大小写只有以下一条规范，但是很重要。 × 不要以为所有的编程语言都是区分大小写的，实际情况并非如此。不应该仅仅
通过大小写来区分名字。 2 通用命名约定
描述了一些通用的命名约定，它们涉及到单词的选择、单词缩写和首字母缩写词 的使用规范以及如何避免使用编程语言特有的名字。
2.1 单 词 的 选 择
写，可以借助最新的英语词典。 表 1-2 列出了一些最为常用的复合词和常用术语的大小写。
表 1-2 常用的复合词和常用术语的大小写及拼写
Pascal BitFlag CallBack Canceled DoNot Email Endpoint FileName Gridline Hashtable Id Indexes LogOff LogOn Metadata Multipanel Multiview Namespace Ok Pi Placeholder SignIn SignOut UserName WhiteSpace Writable
标识符以两个字母长的首字母缩写词开始，那么两个字母都要小写。
propertyDescriptor ioStream htmlTag
下面是一些用于标识符的基本大小写规范。
√ 要把 PascalCasing 用于由多个单词构成的名字空间、类型以及成员的名字。 例如，要使用 TextColor 而不是 Textcolor 或 Text_color。单个单词（比如 Button） 直接首字母大写。始终作为一个单词的复合词（比如 endpoint）视为一个单词，