请不要为了炫耀而写出超短代码

2016-07-11 编程派

编程派微信号：codingpy

本篇原文来自Medium，原文作者为 Allan Reyes ，一名退伍军人兼工程师。
译文来自TechOrange，编程派在此基础上进行了精校。

我常逛像 Exercism 这样的网站，在那里编写或重温一些习题来精进我的编码技巧。现在有个危险的流行正在蔓延，我注意到大家很推崇仅用短短几行的代码，认为这样很优雅、有创意，认为这超棒。

但这完全是鬼扯。Brian Kernighan 说得很对：

「想帮短代码除错比你重写代码还要难两倍。如果你真的觉得自己超会写短代码，那么就等到你帮短代码除错的时候再来看看是不是真的那么厉害吧。」

当你把编码的行数减少到令人费解时，这还会是个容易维护或可长久使用的代码吗？替编码抓错会变得更简单还是更有难度？更重要的是，如果原来的编码跟短代码功能一样，那你是不是有点浪费时间呢？

较短的编码不见得代表是更好、更清楚的编码。当你不小心做的超过了，让编码变的难解，或用了模糊且不必要的模组，你可能会得对你的同事一边装可爱，一边说：

「我浪费超多时间在完美化与複杂化这个简单模组，所以你现在才可以花超多时间来了解它。你不觉得这超棒的吗？❤揪咪，编码忍者敬上。」

这不但毫无意义而且很自私，而且完全只是种自负的表现。不必要而多余的代码的确不好，但短代码也不总是就是比较好。缩短编码与简化编码有很大的不同，因为缩短编码仅仅只是让编码变短。

我们用两种简单 Python 计算程式来找两个字串间的「汉明距离，又称信号距离（hamming distance）」。汉明距离是独立字元的计算中为不可或缺的角色。

以下是 Exercism 上被高度推崇的编码：

这是个超棒的编码 … … 如果你的目的是写出混淆代码（code obfucation）的话。

以下是网站上很不起眼的编码：

它用了超过 15 行以上的编码，汉明距离为 517，但让我来解释为什么这个比第一个范例更好的原因：

伪代码与文档字符串的注解都很清楚。你可以很容易去辨读每个部分与字串的用意，所以任何语言的初级程式员都能理解。有几个「高级程式员（Pythonistas）」能第一眼就理解那个比较短的编码？
每行都只执行 1 到 2 个方法（method）或操作（operation）。现在你在回头看看第一则里有多少个 sum method、a != comparison、 forloop 与神奇的 map method 在同一行里。你可以比较一下，两者之间，哪个比较容易读呢？
有逻辑地帮变数命名，用「i」的代表单一字元的变量。你可以试着把第一个范例丢到一个更大型的程序中，然后试着找找看「x、y、a 或 b」。

综合以上，我们可以清楚了解到每个作者的意图：