保命心经，速看！资格老辈子教你如何写出同事无法维护的代码？

why技术2023年12月15日约 14 分钟

你好呀，我是歪歪。

周末了，我们来聊点轻松愉快的话题。

最近码农圈子里面流行起了一个新词语：防御性编程。

这篇文章就教大家几个防御性编程的小技巧，大家没事的时候可以“逝一逝”，看看是保命心经，还是夺命绝招。

文章的原文是这里：

http://mindprod.com/jgloss/unmain.html

本文是译文，由陈皓，也就是“耗子叔”翻译：

https://coolshell.cn/articles/4758.html

耗子叔把文章节选了一些，也没有完全翻译，简译一下，同时也加入了一些他自己的调侃。

程序命名

容易输入的名字。比如：Fred，asdf
单字母的变量名。比如：a,b,c,x,y,z（陈皓注：如果不够用，可以考虑a1,a2,a3,a4,….）
有创意地拼写错误。比如：SetPintleOpening，SetPintalClosing。这样可以让人很难搜索代码。
抽象。比如：ProcessData, DoIt, GetData… 抽象到就跟什么都没说一样。
缩写。比如：WTF，RTFSC …… （陈皓注：使用拼音缩写也同样给力，比如：BT，TMD，TJJTDS）
随机大写字母。比如：gEtnuMbER..
重用命名。在内嵌的语句块中使用相同的变量名有奇效。
使用重音字母。比如：int ínt（注：第二个 ínt不是int）
使用下划线。比如：_, __, ___。
使用不同的语言。比如混用英语，德语，或是中文拼音。
使用字符命名。比如：slash, asterix, comma…
使用无关的单词。比如：god, superman, iloveu….
混淆l和1。字母l和数字1有时候是看不出来的。

伪装欺诈

把注释和代码交织在一起。

for(j=0; j<array_len; j+ =8)
{
    total += array[j+0 ];
    total += array[j+1 ];
    total += array[j+2 ]; /* Main body of
    total += array[j+3]; * loop is unrolled
    total += array[j+4]; * for greater speed.
    total += array[j+5]; */
    total += array[j+6 ];
    total += array[j+7 ];
}

隐藏宏定义。如：#define a=b a=0-b，当人们看到a=b时，谁也想不到那是一个宏。
换行。如下所示，下面的示例使用搜索xy_z变得困难。

#define local_var xy\
_z // local_var OK

代码和显示不一致。比如，你的界面显示叫postal code，但是代码里确叫 zipcode.
隐藏全局变量。把使用全局变量以函数参数的方式传递给函数，这样可以让人觉得那个变量不是全局变量。
使用同意词。如：

#define xxx global_var // in file std.h&nbsp;
#define xy_z xxx // in file ..\other\substd.h&nbsp;
#define local_var xy_z // in file ..\codestd\inst.h

使用相似的变量名。如：单词相似，swimmer 和 swimner，字母相似：ilI1| 或 oO08。parselnt 和 parseInt， D0Calc 和 DOCalc。还有这一组：xy_Z, xy__z, _xy_z, _xyz, XY_Z, xY_z, Xy_z。
重载函数。使用相同的函数名，但是其功能和具体实现完全没有关系。
操作符重载。重载操作符可以让你的代码变得诡异，感谢CCTV，感谢C++。这个东西是可以把混乱代码提高到一种艺术的形式。比如：重载一个类的 ! 操作符，但实际功能并不是取反，让其返回一个整数。于是，如果你使用 ! ! 操作符，那么，有意思的事就发生了—— 先是调用类的重载 ! 操作符，然后把其返回的整数给 ! 成了布尔变量，如果是 !!! 呢？呵呵。
#define。看过本站那些混乱代码的文章，你都会知道宏定义和预编译对于写出不可读的代码的重大意义。不过，一个具有想像力的东西是——在头文件中使用预编译来查看这个头文件被include了几次，而被include不同的次数时，其中的函数定义完全不一样。

#ifndef DONE
#ifdef TWICE
// put stuff here to declare 3rd time around
void g(char* str);
#define DONE
#else // TWICE
#ifdef ONCE
// put stuff here to declare 2nd time around<
void g(void* str);
#define TWICE
#else // ONCE
// put stuff here to declare 1st time around
void g(std::string str);
#define ONCE
#endif // ONCE
#endif // TWICE
#endif // DONE

文档和注释

在注释中撒谎。你不用真的去撒谎，只需在改代码的时候不要更新注释就可以了。
注释明显的东西。比如：/* add 1 to i */。
只注释是什么，而不是为什么。
不要注释秘密。如果你开发一个航班系统，请你一定要保证每有一个新的航班被加入，就得要修改25个以上的位置的程序。千万别把这个事写在文档中。
注重细节。当你设计一个很复杂的算法的时候，你一定要把所有的详细细设计都写下来，没有100页不能罢休，段落要有5级以上，段落编号要有500个以上，例如：1.2.4.6.3.13 – Display all impacts for activity where selected mitigations can apply (short pseudocode omitted). 这样，当你写代码的时候，你就可以让你的代码和文档一致，如：Act1_2_4_6_3_13()
千万不要注释度衡单位。比如时间用的是秒还是毫秒，尺寸用的是像素还是英寸，大小是MB还是KB。等等。另外，在你的代码里，你可以混用不同的度衡单位，但也不要注释。
Gotchas。陷阱，千万不要注释代码中的陷阱。
在注释和文档中发泄不满。

程序设计

Java Casts。Java的类型转型是天赐之物。每一次当你从Collection里取到一个object的时候，你都需要把其转回原来的类型。因些，这些转型操作会出现在N多的地方。如果你改变了类型，那么你不一定能改变所有的地方。而编译器可能能检查到，也可能检查不到。
利用Java的冗余。比如：Bubblegum b = new Bubblegom(); 和 swimmer = swimner + 1; 注意变量间的细微差别。
从不验证。从不验证输入的数据，从不验证函数的返回值。这样做可以向大家展示你是多么的信任公司的设备和其它程序员。
不要封装。调用者需要知道被调用的所有的细节。
克隆和拷贝。为了效率，你要学会使用copy + paste。你几乎都不用理解别人的代码，你就可以高效地编程了。（陈皓注：Copy + Paste出来的代码bug多得不能再多）
巨大的listener。写一个listener，然后让你的所有的button类都使用这个listener，这样你可以在这个listener中整出一大堆if…else…语句，相当的刺激。
使用三维数组。如果你觉得三维还不足够，你可以试试四维。
混用。同时使用类的get/set方法和直接访问那个public变量。这样做的好处是可以极大的挫败维护人员。
包装，包装，包装。把你所有的API都包装上6到8遍，包装深度多达4层以上。然后包装出相似的功能。
没有秘密。把所有的成员都声明成public的。这样，你以后就很难限制其被人使用，而且这样可以和别的代码造成更多的耦合度，可以让你的代码存活得更久。
排列和阻碍。把drawRectangle(height, width) 改成 drawRectangle(width, height)，等release了几个版本后，再把其改回去。这样维护程序的程序员们将不能很快地明白哪一个是对的。
把变量改在名字上。例如，把setAlignment(int alignment)改成，setLeftAlignment, setRightAlignment, setCenterAlignment。
Packratting。保留你所有的没有使用的和陈旧的变量，方法和代码。That’s Final。Final你所有的子结点的类，这样，当你做完这个项目后，没有人可以通过继承来扩展你的类。java.lang.String不也是这样吗？
避免使用接口。在java中，BS接口，在 C++ 中BS使用虚函数。
避免使用layout。这样就使得我们只能使用绝对坐标。如果你的老大强制你使用layout，你可以考虑使用GridBagLayout，然后把grid坐标hard code.
环境变量。如果你的代码需要使用环境变量。(getenv() – C++ / System.getProperty() – Java )，那么，你应该把你的类的成员的初始化使用环境变量，而不是构造函数。
使用Magic number。
使用全局变量。1）把全局变量的初始化放在不同的函数中，就算这个函数和这个变量没有任何关系，这样能够让我们的维护人员就像做侦探工作一样。2）使用全局变量可以让你的函数的参数变得少一些。
配置文件。配置文件主要用于一些参数的初始化。在编程中，我们可以让配置文件中的参数名和实际程序中的名字不一样。
膨胀你的类。让你的类尽可能地拥有各种臃肿和晦涩的方法。比如，你的类只实现一种可能性，但是你要提供所有可能性的方法。不要定义其它的类，把所有的功能都放在一个类中。
使用子类。面向对象是写出无法维护代码的天赐之物。如果你有一个类有十个成为（变量和方法）你可以考虑写10个层次的继承，然后把这十个属性分别放在这十个层次中。如果可能的话，把这十个类分别放在十个不同的文件中。
使用非英语字母。在命名中偷偷使用不易察觉的非英语字母，例如 typedef struct { int i; } ínt; 。看上去没啥不对是吧？嘿嘿嘿...这里的第二个 ínt 的 í 实际上是东北欧字母，并不是英语中的 i 。在简单的文本编辑器里，想看出这一点点区别几乎是不可能的。

混乱你的代码

使用XML。XML的强大是无人能及的。使用XML你可以把本来只要10行的代码变成100行。而且，还要逼着别人也有XML。（参看，信XML得永生，信XML得自信）
使用不同的进制。比如：10 和010不是一样的。再比如：array = new int[]{ 111, 120, 013, 121,};
尽量使用void*。然后把其转成各种类型
使用隐式的转型。C++的构造函数可以让你神不知鬼不觉得完成转型
分解条件表达式。如：把 a==100分解成，a>99 && a<101
学会利用分号。如：if ( a );else;{ int d; d = c;}
间接转型。如：把double转string，写成new Double(d).toString() 而不是 Double.toString(d)
大量使用嵌套。一个NB的程序员可以在一行代码上使用超过10层的小括号（），或是在一个函数里使用超过20层的语句嵌套{}，把嵌套的if else 转成 [? :] 也是一件很NB的事。
使用C的变种数组。myArray[i] 可以变成*(myArray + i) 也可以变成 *(i + myArray) 其等价于 i[myArray]。再看一个函数调用的示例，函数声明：int myfunc(int q, int p) { return p%q; } 函数调用myfunc(6291, 8)[Array];
长代码行。一行的代码越长越好。这样别人阅读时就需要来来回回的
不要较早的return。不要使用goto，不要使用break，这样，你就需要至少5层以上的if-else来处理错误。
**不要使用{}**。不要在if else使用{}，尤其是在你重量地使用if-else嵌套时，你甚至可以在其中乱缩进代码，这样一来，就算是最有经验的程序员也会踩上陷阱。
使用宏定义。宏定义绝对是混乱C/C++代码的最佳利器。
琐碎的封装。比较封装一个bool类，类里面什么都做，就是一个bool.
循环。千万不可用for(int i=0; i<n; i++)使用while代替for，交换n和i，把<改成<=，使用 i–调整步伐。
翻转通常的 True False 惯例：把常用的 true 和 false 的定义反过来用。这一招听起来平淡无奇，但是往往收获奇效。你可以先藏好下面的定义：

#define TRUE 0
#define FALSE 1

把这个定义深深地藏在代码中某个没人会再去看的文件里不易被发现的地方，然后让程序做下面这样的比较

if ( var == TRUE )
if ( var != FALSE )

某些人肯定会迫不及待地跳出来“修正”这种明显的冗余，并且在其他地方照着常规去使用变量var：

if ( var )

还有一招是为 TRUE 和 FALSE赋予相同的值，虽然大部分人可能会看穿这种骗局。给它们分别赋值 1 和 2 或者 -1 和 0 是让他们瞎忙乎的方式里更精巧的，而且这样做看起来也不失对他们的尊重。你在Java 里也可以用这一招，定义一个叫 TRUE 的静态常量。在这种情况下，其他程序员更有可能怀疑你干的不是好事，因为Java里已经有了内建的标识符 true。

测试

从不测试。千万不要测试任何的出错处理，从来也不检测系统调用的返回值。
永远不做性能测试。如果不够快就告诉用户换一个更快的机器。如果你一做测试，那么就可能会要改你的算法，甚至重设计，重新架构。
不要写测试案例。不要做什么代码覆盖率测试，自动化测试。
测试是懦夫行为。一个勇敢的程序员是根本不需要这一步的。太多的程序太害怕他们的老板，害怕失去工作，害怕用户抱怨，甚至被起诉。这种担心害怕直接影响了生产力。如果你对你的代码有强大的信心，那还要什么测试呢？真正的程序员是不需要测试自己的代码的。

其它

你的老板什么都知道。无论你的老板有多SB，你都要严格地遵照他的旨意办事，这样一来，你会学到更多的知识如何写出无法维护的代码来的。
颠覆Help Desk。你要确保你那满是bug的程序永远不要被维护团队知道。当用户打电话和写邮件给你的时候，你就不要理会，就算要理会，让用户重做系统或是告诉用户其帐号有问题，是标准的回答。
闭嘴。对于一些像y2k这样的大bug，你要学会守口如瓶，不要告诉任何人，包括你的亲人好友以及公司的同事和管理层，这样当到那一天的时候，你就可以用这个bug挣钱了。
忽悠。你会学会忽悠，就算你的代码写得很烂，你也要为其挂上GoF设计模式的标签，就算你的项目做得再烂，你也要为其挂上敏捷的标签，只有学会像xxx咨询师那样去忽悠，你才能学会更炫更酷的方法，让整个团队和公司，甚至整个业界都开始躁动，这样才能真正为难维护的代码铺平道路。

这个文档中还有很多很多，实在是太TMD强大了，大家自己去看看吧。有精力有能力的朋友不妨把其翻译成中文。

总之，我们的口号是——

Write Everywhere, Read Nowhere
到处可写，无处可读。

荒腔走板

相信大家看完全文之后拳头已经捏的很紧了，如果真的遇到这样的代码，很难保持镇定。

所以，防御性编程，当个段子听听就行了，乱世之下，真想保命，还得是自己有一身真功夫、硬本领才行。

另外，文章的开头耗子叔也说了“自己并没有全文翻译，只是节选了部分”，所以歪师傅也点开了这个文章的原文：

https://www.mindprod.com/jgloss/unmain.html

在原文的开头，有原作者这样的一段话：

这段话非常重要，是作者自己描述的创作这篇文章的出发点，所以要仔细看看。

看到大段英文不要紧张，你知道的，歪师傅的 English level 是比较 high 的，张口就是 abandon 这样的高级词汇。

所以歪师傅带路，根本不要慌，带你拆解一下长句。

首先，第一句：

In the interests of creating employment opportunities in the Java programming field

开始就是一个小短语，In the interests of...，翻译过来是“为了…的利益”，也可以翻译为“有助于”，大概是这个意思。

那么，有助于什么呢？

“creating employment opportunities”

这个应该都认识：创造工作机会。

创造什么工作机会呢？

“Java programming field”

所以第一句翻译过来就是：

为了在 Java 编程领域创造就业机会。

然后呢，他说啥了？

I am passing on these tips from the masters on how to write code that is so difficult to maintain

他说：我教各位 masters，也就是大师几招关于如何编写难于维护的代码的秘诀。

你学会你之后：

that the people who come after you will take years to make even the simplest changes.

注意，这里用了个倒装句，把 even the simplest changes 放在了最后。

但是翻译的时候需要先翻译它：你学会之后啊，即使是最简单的更改，在你之后的人也需要 take years（花费数年时间）才能搞定。

然后，重点来了：

Further, if you follow all these rules religiously, you will even guarantee yourself a lifetime of employment，

这句话很简单，没有什么比较困难的单词，但是其中有个 guarantee yourself，这是个重点词组，记下来，肯定是要考的：

这句话是说：如果你虔诚地遵循所有这些规则，你甚至可以保证自己终生就业。

为什么呢？

since no one but you has a hope in hell of maintaining the code. Then again, if you followed all these rules religiously, even you wouldn’t be able to maintain the code!

因为除了你，没有人有希望维护这些魔鬼般的代码。再说一遍，如果你虔诚地遵守所有这些规则，即使你也无法维护代码！

然后，最后一句：