命名困难症：程序员最头疼的事

那些年我们起过的名字命名的三大流派结语

678 字

3 分钟

命名困难症：程序员最头疼的事

2026-08-22

其他

命名

/

编程习惯

/

程序员笑话

编程界有一句流传极广的名言：

There are only two hard things in Computer Science: cache invalidation and naming things.

翻译过来就是：「计算机科学里只有两件难事：缓存失效和命名。」 这句话出自 Netscape 工程师 Phil Karlton 之口，被 Martin Fowler 收录进文章《TwoHardThings》，从此成为程序员之间心照不宣的自嘲。

好笑的是，这句话后来被网友玩出了无数个续集版本。最经典的一个是：「计算机科学里只有两件难事：缓存失效、命名，以及 off-by-one 错误。」——数一数，正好三件，多出来的那一件就是 off-by-one 错误。这个冷幽默本身就是一个完美的 off-by-one 演示。

那些年我们起过的名字#

翻一翻自己的旧代码，几乎每个人都能找到一段命名车祸现场。下面这段「猜猜看」你能读得下去吗：

1
function handleData(d) {
2
  let x = d.a;
3
  let tmp = [];
4
  for (let i = 0; i < x.length; i++) {
5
    if (x[i].flag === 1) {
6
      tmp.push(x[i].v);
7
    }
8
  }
9
  return tmp;
10
}

d 是什么？a 是什么？flag === 1 又代表什么状态？——每个变量都在大喊「你猜啊」。而它的作者，三个月后再看到这段代码时，大概率也会加入猜谜的队伍。

改个名字，世界瞬间清晰：

1
function getActiveUsernames(users) {
2
  return users
3
    .filter((user) => user.isActive)
4
    .map((user) => user.username);
5
}

变量名真正的读者不是编译器，而是未来的自己和接手你代码的同事。编译器才不在乎你叫它 x 还是 activeUserCount，但凌晨三点排查线上问题时，一个清晰的命名能省下半小时的 console.log。

命名的三大流派#

现实中的烂名字大致分为三派：

摆烂派：data、info、tmp、foo、bar、a1、x2。变量多了就 data2、data3，生生排出一支军队。
万能派：manager、handler、utils、helper、processor。一个项目里可以有八个 Manager，谁也不清楚谁管谁。
废话派：theData、dataValue、userObject、getData()。加了个词等于没加，纯粹为了凑字数。