匈牙利命名法

定锚

匈牙利命名法(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:Windows DWORD。
  • 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 不同,应用匈牙利命名法希望通过名字暴露这种差异。

例子:

1
2
3
4
5
int iStudent = 3;      // 第 4 个学生的索引
int cStudent = 30;     // 学生总数
int cbBuffer = 1024;   // 缓冲区字节数

// 类型都是 int,但含义不能随意相加或替换。

公式的失效处也很明确:前缀不会被编译器检查。变量从 int 改成 long long 后,旧名 iCount 可能没有同步修改;团队对前缀含义理解不一致时,名称反而制造误导。

存在

匈牙利命名法改变了程序员看变量的方式:变量不再只是一个存值的盒子,而是带着“我能参与哪些运算”的身份。它训练初学者区分表示与含义,也可能让人误以为记住数据类型就等于理解了变量。

在现代项目里,成熟做法是先让类型系统承载约束,再让清晰的业务名称补足剩余语义。命名前缀只能充当提示,不能代替类型、测试和代码审查。

美感

它像给仓库中的箱子贴标签。同样大小的纸箱,如果分别写着“食品”“易碎品”“待消毒”,搬运者会采用不同动作。前缀的美感来自秩序:在代码还没运行前,名字已经暗示了允许和禁止的操作。

这种秩序也有代价。标签过密时,lpszUserName 会遮住最重要的 UserName,代码看起来像缩写密码本。

元反思

系统匈牙利命名法采用“变量是容器”的隐喻,前缀说明容器材质:整数、指针、句柄。这个隐喻会遮住内容的单位、来源和安全状态。

应用匈牙利命名法采用“变量是有量纲的量”的隐喻,前缀说明它能与什么值运算。换成现代视角,最可靠的方案是把重要语义升级为真实类型;只有暂时无法进入类型系统的信息,才考虑放进名字。

内观

我是一个变量名。编译器只需要知道我绑定了哪个对象,程序员却靠我判断这个对象能做什么。若我的前缀只是重复 int,我会随着重构迅速过时;若我提醒你这是字节数、索引或未验证输入,我能在错误发生前让你停一下。我的价值取决于我提供了工具尚未提供的信息。

八刀共同指向一个深层结构:命名是轻量、非强制的类型系统。历史说明它为何出现,辩证与形式说明它弥补什么,元反思则指出它应把位置让给更可靠的语言类型。

压缩

公式

匈牙利命名法 = 前缀标签 + 业务名称;标签价值 = 它提供的语义 - 工具已经提供的信息 - 维护成本

一句话

匈牙利命名法把变量的额外约束写在名字前面;现代代码应少写机器类型,多保留编译器看不见的业务语义。

结构图

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
                    Hungarian notation
                            |
              +-------------+-------------+
              |                           |
       Systems Hungarian           Apps Hungarian
       machine type                semantic kind
              |                           |
       iCount pUser                cbBuffer iItem
              |                           |
       IDE/compiler repeats        catches meaning mismatch
              |                           |
       often avoid today           sometimes still useful
              +-------------+-------------+
                            |
                 prefer real domain types

学会使用

先用一个判断流程:

  1. 项目已有规范时,保持一致,不自行混入另一套前缀。
  2. 新项目先写清楚的业务名,如 userCount、bufferSizeBytes。
  3. 若两个值机器类型相同却不能互换,优先建立真实类型;做不到时,再考虑稳定且有文档的语义前缀。
  4. 前缀必须短、稳定、全项目同义。不能靠个人临时发明。
  5. 类型或语义变化时,名称也必须重构。

系统匈牙利命名示例:

1
2
3
4
bool bLoggedIn = false;
int iRetryCount = 0;
char* pszUserName = nullptr;
User* pCurrentUser = nullptr;

读法分别是:布尔型的登录状态、整数型的重试次数、指向零结尾字符串的用户名、指向 User 的当前用户。它们能暴露机器表示,但在现代 C++ 中通常信息重复。

应用匈牙利命名示例:

1
2
3
4
int iOrder = 4;          // 订单索引
int cOrder = 20;         // 订单数量
int cbPacket = 512;      // 数据包字节数
int msTimeout = 3000;    // 超时毫秒数

iOrder < cOrder 有明确含义。iOrder + cbPacket 虽然能编译,但名字提醒我们这很可能是错误。msTimeout 使用完整单位前缀,比只写 iTimeout 更能防止把毫秒误当成秒。

现代 C++ 的改进方案:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
#include <chrono>
#include <cstddef>

struct OrderIndex {
    std::size_t value;
};

std::chrono::milliseconds timeout{3000};
OrderIndex currentOrder{4};
std::size_t orderCount = 20;

这里 milliseconds 与 OrderIndex 把约束交给类型系统,可靠性高于命名前缀。orderCount 直接写业务含义即可。

错误示例与修正:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
// 问题一:只看前缀,业务含义太弱
int i = 30;

// 修正
int studentCount = 30;

// 问题二:改了类型,忘了改名称
long long iFileSize = 8'000'000'000LL;

// 修正:名称表达含义和单位
long long fileSizeBytes = 8'000'000'000LL;

// 问题三:同一前缀在团队中有两种解释
int sValue = 10; // s 是 short、string、signed,还是 seconds?

// 修正
int timeoutSeconds = 10;

自测

  1. int iAge 属于哪一种?答:系统匈牙利命名法,因为 i 只说明 int。
  2. int cbImage 属于哪一种?答:更接近应用匈牙利命名法,因为 cb 说明这是字节数,int 本身不包含单位。
  3. pCustomer 的主要风险是什么?答:指针类型变化后名称会过时,而且“指针”通常能由语言和 IDE 直接看出。
  4. secondsTimeout 与 millisecondsDelay 能相加吗?答:底层若都是整数,编译器可能允许;语义上必须先统一单位。
  5. 新 C++ 项目是否应全面采用 i、f、p?答:通常不应。优先遵守项目规范,使用业务名称和真实类型。
  6. 维护旧 Windows C/C++ 代码时看到 hWnd、lpRect 应全部改掉吗?答:不应机械改名。先理解既有约定,并评估 API 一致性、修改范围和收益。

判断你是否真正掌握的标准:看到前缀时,你能说出它编码的是机器表示还是业务语义;设计名字时,你能解释这项信息为何不能交给类型系统或普通业务名称表达。

使用 Hugo 构建
主题 Stack 由 Jimmy 设计