Claude 爱在注释里写小作文:建议把理由挪到单独文件

Birchlabs · x · 2026-08-25

推友 Birchlabs 观察:Claude 倾向在代码注释里留下大段文字——这些注释实质上是它的 CoT 推理序列,或在 code review 中用「墓碑注释」解释 diff 的取舍。这大概对模型自己有利,对读代码的用户未必友好。

作者给出的做法是:允许它写,但写到别处——在代码注释里只留一句指引,如「为冷门边界情况加了防护,理由见 service.annex.md」,把长篇 rationale 放到独立文档中,兼顾模型推理需求与代码可读性。

原文链接 →

「编程与Agent」频道最新

更多「编程与Agent」频道 AI 资讯 →