这问题的背后是没有答案
但我们可以根据目前世界一流的repo 来参考
绝大部分的世界级的framework 包含 linux
专案里面都一定会有注解 只是注解多 或 注解少
其中让我最喜欢的 专案大概是 laravel 连注解都写得很艺术
我自己是赞成部分写注解 而且要写清楚
当专案架构越来越大 开发的人越来越多
尤其是 -> 功能越加越多
上头 随便天马行空就来一笔 OOXX 的需求
( X的！当初为什么不讲，现在要怎么弄 )
不太可能没有技术债的产生
有时候因为时程关系 / 前人留下的技术债 / 上头的天马行空的新需求
有些地方是牵一发动全身
虽然明知道最好的办法是 某feature全部打掉重练 但是 整个重写至少2个礼拜
照现在的逻辑下去写 2个小时 以先解决的目前的ticket目的的前提
会让你陷入一个 就算名称取再好
你也无法讲述清楚的情况
所以这时候写注解 可以省去后来维护的人 或 几个月的自己
方便快速地进入状况
这时候 我是赞同写注解
非此情况下的注解 我会比较希望看到 整个全局的概述 而非 单个block的论述