程序员代码大全

凌晨三点，程序我盯着屏幕上的员代报错信息，第十一次尝试修复那个内存泄漏。程序隔壁工位的员代同事早就走了，只有咖啡机还在嗡嗡作响。程序那一刻我突然意识到，员代所谓《程序员代码大全》，程序其实不是员代一本放在书架上的书，而是程序这些年踩过的坑、熬过的员代夜、删掉的程序代码行。

很多人以为代码写得多就是员代厉害。我见过一个哥们，程序一天能提交两千行，员代结果review的程序时候被组长骂了半小时——他复制粘贴了五个几乎相同的函数，只是参数名不一样。代码大全的第一条铁律：重复是万恶之源。不是让你把三行相似代码强行抽象成一个函数，而是当同样的逻辑出现第三次时，就该停下来想想了。我自己的习惯是，看到第二个相似块就加注释标记，第三个出现立刻重构。这个阈值不是固定的，但必须有。

命名这件事，比大多数人想的要命。变量叫data、temp、flag，过两周自己都看不懂。我维护过一个老项目，里面有个函数叫processInfo，点进去一看，它干的事是：校验用户输入、查数据库、发邮件、写日志、还顺手改了一个全局变量。这种函数就像瑞士军刀，什么都能干，但你要用的时候永远找不到正确的刀片。后来我把它拆成四个函数，每个名字都直白到无聊，比如validateUserInput、sendNotificationEmail。无聊的名字才是好名字。

注释不是越多越好。我见过每行都加注释的代码，读起来像在嚼蜡。i++ // 增加i的值——这种注释不如没有。真正有用的注释是解释“为什么”，而不是“是什么”。比如：

// 这里用二分查找而不是哈希表，因为数据量小于50且需要保持顺序 int index = binarySearch(arr, target);

这种注释能帮下一个接手的人省下半小时的困惑。我自己写注释有个笨办法：假设三个月后的自己是个脾气暴躁的陌生人，他读这段代码时会骂什么？把那个问题的答案写下来。

错误处理是区分新手和老手的分水岭。新手写try { ... } catch (Exception e) { }，空catch块就像把垃圾扫到地毯下面。老手会想：这个异常我能处理吗？不能处理就往上抛，能处理就做具体的事。我见过最离谱的代码，数据库连接失败后继续执行，然后拿着null对象调方法，最后报了个空指针，排查了两小时才发现根因是网络问题。现在我的习惯是：每个catch块里至少写一行日志，或者抛出一个带上下文的自定义异常。

代码大全里没写但很重要的一条：删除代码比添加代码更需要勇气。上个月我删了三百行“可能以后有用”的代码，那是两年前某个需求留下的。删完之后测试全绿，部署上线，什么也没发生。那些注释掉的代码、if (false)的分支、永远返回null的备用函数，都是技术债。版本控制会记住一切，你不需要在文件里留墓碑。

最后说个反直觉的观察：写得快的程序员往往不是最好的。我认识一个技术大牛，他写代码像在雕刻，一个函数能改七八遍。有次我问他为什么这么慢，他说：“我现在花二十分钟想清楚边界条件，比上线后花两天修bug划算。”后来我算过一笔账，修复生产环境bug的平均时间是编写代码的六倍。慢就是快，这话在编程里是真的。

屏幕上的报错终于消失了。我关掉IDE，窗外天快亮了。代码大全不在任何一本书里，它在每一次你忍住不复制粘贴的瞬间，在每一个你认真取名的变量里，在那些你删掉的“以后可能有用”的代码中。