你有没有发现，工程师文化里有一种很奇特的现象：“不需要说明”本身就是最大的说明。

你有没有发现，工程师文化里有一种很奇特的现象：“不需要说明”本身就是最大的说明。

资深工程师说“这段 code 看就知道在干嘛，不用加注释”，然后所有人点头，包括你。

但你点头的当下，心里其实有个问号，只是没说出来。这很正常，我们都这样过。

问题在于，三个月后那个“看就知道”的函数没人敢动，因为没人知道当初 if/else 为什么那样写，连原作者自己也要花五分钟回忆。

这背后是认知偏差：写代码时思路清晰、逻辑连贯，所有背景都在作者脑子里，所以“自解释”。

一旦离开情境，清晰就消失了。

好的代码让人读懂“做什么”，但只有好的注释才能让人读懂“为什么”。

带团队的人，你的 team 对加不加注释有没有共识？