代码注释的多少是代码质量的"反向指标"

需要大量注释才能理解的代码，本身就是坏代码的信号。好的代码应该是"自文档化"的——通过清晰的命名、良好的结构、适当的抽象，让代码本身就能说明意图。注释应该解释"为什么"（设计决策），而不是"是什么"（代码在做什么）。