大家注释用中文还是英文

2017-03-24 09:47:03 +08:00
 mec

自己写代码有注释的习惯,感觉用中文每次 review 会更快进入状态。那么,如何看待在业务代码中用英文注释的行为捏(非开源项目),大家都怎么注释

11545 次点击
所在节点    问与答
59 条回复
song940
2017-03-24 11:25:59 +08:00
所以说「要关注问题本身而非形式」,最终要达到的目的是让大家看懂,中文还是英文很重要吗?
Shura
2017-03-24 11:45:44 +08:00
阿里代码规范文档里有句话印象深刻:与其用半吊子的英语大家都不能理解,还不如用中文精确的描述。
libook
2017-03-24 12:15:39 +08:00
@song940 哈哈,好久不见
sagaxu
2017-03-24 12:32:16 +08:00
基本不写注释,只在关键点写几句解释一下为什么这么做
HLT
2017-03-24 12:36:19 +08:00
肯定英文啊
nicevar
2017-03-24 12:38:40 +08:00
公司的项目写中文,都是国人,五六年前的时候在一公司也写英文,因为那时候用 svn ,有些 ide 容易导致文件乱码,写的中文注释都没了
自己的项目写英文,几个单词拼起来能看懂就够了,中文还要切换输入法
momogzp
2017-03-24 12:49:44 +08:00
英文,切换中英文有点麻烦。。
tyfulcrum
2017-03-24 12:50:43 +08:00
@libook 重载是 overload 吧……
loading
2017-03-24 13:05:56 +08:00
蹩脚英文就不写了吧……
hdbean
2017-03-24 14:58:31 +08:00
能用中文写清楚的就不用中文
ik
2017-03-24 15:18:32 +08:00
看情况,极端情况用拼音😂
jhaohai
2017-03-24 15:35:23 +08:00
自己英语蹩脚的话干脆就中文算了,省的麻烦,都是中国人看
murmur
2017-03-24 15:38:16 +08:00
@libook 用中文的问题:一些没有官方中文翻译的技术、概念强行用中文的话会很蛋疼,比如“ Buffer ”、“
Query ”、“ Cluster ”、“ Debug ”、“ Delay ”、“ Scrum ”等等,

debug 除了调试还有其他意思可以翻译么
还有 query
catror
2017-03-24 15:43:00 +08:00
有时候自己写的代码被几个人改过之后发现里面的中文注释全是乱码,所以就干脆改写英文注释了
RqPS6rhmP3Nyn3Tm
2017-03-24 15:58:54 +08:00
我是想用拉丁文写注释的,可惜会被教授打,所以只能英文了
strwei
2017-03-24 16:04:16 +08:00
/**
* 写这段代码的时候,只有上帝和我知道它是干嘛的
* 现在,只有上帝知道
*/
tilv37
2017-03-24 16:37:41 +08:00
我的代码一般就自己看,最多是项目同组的人一起,没得写英文的必要。再说,我也写不出英文呀~
ydq419453527
2017-03-24 16:38:04 +08:00
简单的会英文
复杂的还是中文 (其实是英文不行)
xxdd
2017-03-24 17:04:42 +08:00
复杂的中文 简单的就是英文了 都是常用单词 懒得切输入法了
Email
2017-03-24 17:10:54 +08:00
一般留个磁链在注释那里

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/349933

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX