定锚
匈牙利命名法(Hungarian notation)是在标识符主体前加简短前缀,用名字携带额外信息的命名约定。它不改变变量的真实类型,也不会影响编译结果;作用发生在程序员阅读代码时。
最常见的误解是把它等同于“把 C/C++ 数据类型缩写放在变量名前”。那只是后来流行的系统匈牙利命名法。较早的应用匈牙利命名法更关心数值的用途、单位、状态和可否互换。
核心词素:
- 前缀:名字开头的短标签,如
p、i、cb。 - 基础名:对象的业务名称,如
userName、buffer、price。 - 种类(kind):值在程序中的语义角色,如字节数、索引、屏幕坐标。
- 表示类型(representation type):语言或机器看到的类型,如
int、char*、DWORD。
八刀
历史
Charles Simonyi 在早期软件开发中提出了这套约定,后来在微软得到传播。“Hungarian”既指他的匈牙利背景,也呼应匈牙利姓名把家族名放在名字前面的顺序:先给出类别,再给出具体名称。
早期弱类型语言、简单编辑器和大型 C 项目缺少现代 IDE 的类型提示,前缀能在阅读处快速补充约束。后来 Windows 代码大量采用 dwCount、pszName 这类表示机器类型的写法,使“匈牙利命名法”逐渐被大众理解为类型前缀。
现代静态类型语言、IDE 和重构工具能够直接显示机器类型。微软当前文档说明,Windows 团队内部已经不再使用这种前缀风格,但旧 API、示例和文档仍保留大量历史名称。
辩证
它的反面是让名称只表达业务含义,把类型交给语言和工具。例如 userCount 比 iUserCount 更强调“用户数量”,编译器负责说明它是 int。
两者碰撞后可以得到更准确的原则:名字应优先记录编译器看不见、却会影响正确性的语义。机器类型通常不必重复;单位、编码状态、安全状态等约束若无法由类型系统表达,写进名称仍可能有价值。
现象
设想程序里有两个 int:一个表示数组下标,一个表示字节数。编译器允许 index + byteCount,但这通常没有意义。若写成 iItem 与 cbBuffer,阅读者能在运算发生的位置察觉两种量不匹配。
这揭示了匈牙利命名法的实际用途:它让“机器认为相同、业务认为不同”的值在人眼中显出差别。
语言
一个典型名字可以理解为:
[scope][prefix][baseName][qualifier]
例如 g_pUserCurrent 可读成“全局的、指向 User 的、当前对象”。实际项目不一定使用全部部分,也不存在跨项目统一的完整前缀表。
常见系统型前缀:
bReady:bool。iCount:int。pUser:指针。pszName:指向零结尾字符串的指针。dwFlags:WindowsDWORD。hWnd:窗口句柄。m_count:成员变量。严格说这是作用域标记,常与匈牙利风格一起出现。
常见应用型前缀:
iItem:项目索引。cItem:项目数量。cbBuffer:缓冲区占用的字节数,cb可理解为 count of bytes。xScreen、yScreen:屏幕坐标。row、col:行号和列号。usName、sName:不安全字符串与已安全处理字符串。这是示意性项目约定,不是通用标准。
相邻概念要分清:
- 驼峰命名法规定单词怎样连接,如
userCount;匈牙利命名法规定名字携带什么前缀,如iUserCount。两者可以同时使用。 - 类型系统由编译器执行,命名约定由团队自觉执行。
m_、g_表示作用域;p、i常表示机器类型;cb、row更接近语义种类。
形式
把一个变量写成:
Name(v) = Scope(v) + Kind(v) + Meaning(v) + Qualifier(v)
其中真正影响正确性的条件是:
可安全互换(v1, v2) => Kind(v1) = Kind(v2)
如果两个变量的 C++ 类型相同,但 Kind 不同,应用匈牙利命名法希望通过名字暴露这种差异。
例子:
| |
公式的失效处也很明确:前缀不会被编译器检查。变量从 int 改成 long long 后,旧名 iCount 可能没有同步修改;团队对前缀含义理解不一致时,名称反而制造误导。
存在
匈牙利命名法改变了程序员看变量的方式:变量不再只是一个存值的盒子,而是带着“我能参与哪些运算”的身份。它训练初学者区分表示与含义,也可能让人误以为记住数据类型就等于理解了变量。
在现代项目里,成熟做法是先让类型系统承载约束,再让清晰的业务名称补足剩余语义。命名前缀只能充当提示,不能代替类型、测试和代码审查。
美感
它像给仓库中的箱子贴标签。同样大小的纸箱,如果分别写着“食品”“易碎品”“待消毒”,搬运者会采用不同动作。前缀的美感来自秩序:在代码还没运行前,名字已经暗示了允许和禁止的操作。
这种秩序也有代价。标签过密时,lpszUserName 会遮住最重要的 UserName,代码看起来像缩写密码本。
元反思
系统匈牙利命名法采用“变量是容器”的隐喻,前缀说明容器材质:整数、指针、句柄。这个隐喻会遮住内容的单位、来源和安全状态。
应用匈牙利命名法采用“变量是有量纲的量”的隐喻,前缀说明它能与什么值运算。换成现代视角,最可靠的方案是把重要语义升级为真实类型;只有暂时无法进入类型系统的信息,才考虑放进名字。
内观
我是一个变量名。编译器只需要知道我绑定了哪个对象,程序员却靠我判断这个对象能做什么。若我的前缀只是重复 int,我会随着重构迅速过时;若我提醒你这是字节数、索引或未验证输入,我能在错误发生前让你停一下。我的价值取决于我提供了工具尚未提供的信息。
八刀共同指向一个深层结构:命名是轻量、非强制的类型系统。历史说明它为何出现,辩证与形式说明它弥补什么,元反思则指出它应把位置让给更可靠的语言类型。
压缩
公式
匈牙利命名法 = 前缀标签 + 业务名称;标签价值 = 它提供的语义 - 工具已经提供的信息 - 维护成本
一句话
匈牙利命名法把变量的额外约束写在名字前面;现代代码应少写机器类型,多保留编译器看不见的业务语义。
结构图
| |
学会使用
先用一个判断流程:
- 项目已有规范时,保持一致,不自行混入另一套前缀。
- 新项目先写清楚的业务名,如
userCount、bufferSizeBytes。 - 若两个值机器类型相同却不能互换,优先建立真实类型;做不到时,再考虑稳定且有文档的语义前缀。
- 前缀必须短、稳定、全项目同义。不能靠个人临时发明。
- 类型或语义变化时,名称也必须重构。
系统匈牙利命名示例:
| |
读法分别是:布尔型的登录状态、整数型的重试次数、指向零结尾字符串的用户名、指向 User 的当前用户。它们能暴露机器表示,但在现代 C++ 中通常信息重复。
应用匈牙利命名示例:
| |
iOrder < cOrder 有明确含义。iOrder + cbPacket 虽然能编译,但名字提醒我们这很可能是错误。msTimeout 使用完整单位前缀,比只写 iTimeout 更能防止把毫秒误当成秒。
现代 C++ 的改进方案:
| |
这里 milliseconds 与 OrderIndex 把约束交给类型系统,可靠性高于命名前缀。orderCount 直接写业务含义即可。
错误示例与修正:
| |
自测
int iAge属于哪一种?答:系统匈牙利命名法,因为i只说明int。int cbImage属于哪一种?答:更接近应用匈牙利命名法,因为cb说明这是字节数,int本身不包含单位。pCustomer的主要风险是什么?答:指针类型变化后名称会过时,而且“指针”通常能由语言和 IDE 直接看出。secondsTimeout与millisecondsDelay能相加吗?答:底层若都是整数,编译器可能允许;语义上必须先统一单位。- 新 C++ 项目是否应全面采用
i、f、p?答:通常不应。优先遵守项目规范,使用业务名称和真实类型。 - 维护旧 Windows C/C++ 代码时看到
hWnd、lpRect应全部改掉吗?答:不应机械改名。先理解既有约定,并评估 API 一致性、修改范围和收益。
判断你是否真正掌握的标准:看到前缀时,你能说出它编码的是机器表示还是业务语义;设计名字时,你能解释这项信息为何不能交给类型系统或普通业务名称表达。