AI 写代码,注释要不要全删掉?
Kevin在Coding · 2026-10-19T08:30:18
用 Agent 写代码,注释留多了有时反而是个麻烦。有工程师提出应该删掉 AI 代码库里的大多数注释,理由是 Agent 读到之前的临时 workaround 或过期说明时,很容易像病毒一样照抄扩散。她在 pstack 里做了个叫 /no-comments 的 skill(支持 Cursor,也能在 Claude Code、Codex 载入),专门清理无用注释,只留浏览器兼容等极少数必要说明,并尝试去改根因。 不过这个做法也引来了不少反对,比如 Sentry 的 David Cramer 就觉得,真正有价值的代码意图本来就该写在注释里,全删掉并不现实。到底是让代码彻底自解释、不给 Agent 留误导线索,还是继续靠注释传达意图,社区里还在争论。