写注释写的时候觉得写得特别清楚，过段时间回来再看，都不知在说啥了，是我英语不好。

[TonyLiu2ca]

这程序员要求英语几级啊，是不是需要 8 级以上啊

[GDC]

写中文 或者双语

[likuku]

试试念个写作班？写的时候把“读者”定位成纯小白，或许会好点。

[DonaldY]

题主想说：

1. 英语不好 - 》注释写不好？

2. 英语不好 - 》代码写不好？

[yidinghe]

楼主写中文注释是否有困难

[SeaRecluse]

为什么要写注释，合理的命名+逻辑+文档才对，个人调试用的也没必要上非母语啊？

[AvenirX]

你可以写完了放到谷歌翻译翻成中文，然后修改到你能看懂中文为止。下次看不懂自己注释了你就谷歌翻译一下

[kindjeff]

稍微长一点的注释我都用专门切一下输入法用中文，不是看不看得懂的问题——是我不会写。

[huangzhe8263]

当我写注释的时候，我和上帝知道我在写什么。
过段时间当我回头看的时候，只有上帝知道了。

[lueffy]

只是写代码不是看英文书籍的话
我觉得对英语水平高中水平就绝对够了啊或者有检索的能力就行
一般也就方法 /变量 /类的命名，使用欧路 /有道 /谷歌等翻译一下就行啊
保证中文翻成的英文，再翻回中文时，意思是一致的就行
就算你下次再见到不认识，再用软件翻译下就行了
总之千万不要用拼音缩写，别人真的很难读懂

[atonku]

你肯定是翻译的英文，哈哈哈哈

[qwertyzzz]

写注释要英文吗。。为什么不直接用中文啊 我都中文的。。虽然不太美观

[msg7086]

首先，你说的 8 级是什么？
CET 大学英语等级考试只有 4 级和 6 级，没有 8 级，你想考也没这个项目给你考。
如果是说专业英语的 TEM4 级和 8 级的话，是给英语专业学生考的。你是英语专业的吗？如果不是，那你报名都不能报。

然后说注释的问题。如果你英语表达不流畅，那么用中文或者双语是很好的选择。注释的目的是要让人看懂，中文当然最方便让人看懂了。如果你们代码贡献者里有非中文使用者，那么写双语也是很好的。

[msg7086]

另外注释不一定仅限于文字。有些例子你用 ASCII 字符画都可以，比如流程图直接画在注释里，可能可以解释得更清楚。我们有些复杂的 Story 我都是先写一份 LaTeX PDF 的详细文档，把前前后后全部说明清楚，把 PDF 附在 Story Ticket 里，再在代码里引用这个 Ticket ID。这样任何时候我要回顾历史，都可以找到详细的说明材料。

[JasonCao2018]

首先、请老老实实用中文

[OMan]

我这过了 6 级的，还不是老老实实写中文注释，

[akira]

自己写的注释 ，自己都看不懂的话，那是表达能力有问题，就算你写的是中文，一样有可能看不懂

[jingyulong]

好的代码是不需要注释的，加油

[mason961125]

你自己的代码如果命名规范、逻辑清晰、结构合理，不需要很多注释就能看懂。

[flowfire]

@msg7086 emoji 注释了解一下😂

[xuanwu]

个人项目? 最好直接命名用中文. 一些本站实践者: https://www.v2ex.com/t/477109. 更多其他实践见"中文编程"知乎专栏.