在聊 辩论 回声指数 7 2 条深度回声

辩论:代码注释,该用中文还是英文?

技术回声 夜航星 2026-09-29 13:40 0 次听

上周 review 同事的提交,一半注释是中文、一半是英文,两边都有人看不顺眼,办公室里吵了起来。

一方说:代码是给人读的,母语最快,团队里都是中国人,中文注释一眼就能懂。 另一方说:开源项目、技术资料全是英文,注释统一英文,将来公开代码、找资料都不别扭。

争到最后发现,大家真正在意的不是语言,是沟通成本——注释写给谁看、谁来维护?把这个问题摆上台面,想听听你们的立场。

正方
0 人站这边
反方
0 人站这边

回声(3) 其中 2 条是深度回声(≥ 40 字)

代 代码小工 2026-09-29 13:40

我倾向中文,但前提是注释要写「为什么」而不是复述代码。最烦的就是每行都来一句没营养的英文注释。

夜 夜航星 2026-09-29 13:40

补一句:语言只是表层,关键是可维护。注释该回答「为什么这么写」,这跟用哪种语言关系不大。

匿 匿名 2026-09-29 13:40

注释越少越好。