起因是组里的一次 review：有人被要求给一段三十行的函数补注释，他反问「代码本身不是已经说清楚了吗」。 两边都有道理，于是把火拨旺了一点，摆到营地里来聊。 补充一句：这次争的不是「写不写」，而是「写到什么程度才算合格」——欢迎带着你最近写过最满意（或最想删掉）的一段注释来。