大家的代码注释有写中文的吗?

2022-10-15 12:06:01 +08:00
 yhm2046

昨天公司内部培训代码规范,我提出中文注释会导致乱码问题, cto 直接说以后不能用中文和拼音全部用英文, ceo 说第一次听到有人注释用中文. 我的疑问 1.是否所有大公司都不允许注释用英文和拼音? 2.如果全部用英文那英文水平一般的怎么根据关键字查找代码,比如我第一次写的英文单词跟后面不一样或者忘了查起来比较麻烦,类似 git log 这种用中文也比较直观,这也是我一直用中文的原因.

8467 次点击
所在节点    程序员
99 条回复
ijixiangus
2022-10-15 12:07:43 +08:00
以 「大部分人能看懂」 为原则
FreeEx
2022-10-15 12:10:07 +08:00
没去过外企,我都是写中文注释。
chenshun00
2022-10-15 12:21:18 +08:00
为什么中文注释会导致乱码问题呢. 我迷茫了
Mzs
2022-10-15 12:22:13 +08:00
乱码问题统一字符集格式就不会出现
1.不是,很多都是中文的,大家统一约定就行或者按照公司要求来
2.如果一定要用英文,就慢慢适应就好
vvhhaaattt
2022-10-15 12:28:24 +08:00
团队有部分人在海外,不过都是中文母语
有同事注释写英文,应该是之前推过这方面规范,我觉得没啥用,除非团队中真的非中文母语有一定比例,非母语注释还得脑内翻译下。
dayeye2006199
2022-10-15 12:35:47 +08:00
英文编码 中文注释会频繁导致输入法切换来切换去。
关键我还用 vim mode ,这个酸爽。。。
XiLingHost
2022-10-15 12:37:44 +08:00
一般不用,毕竟中文要输入法,而且确实存在编码问题,虽然现在大多数都是 utf-8 ,但是在某些终端下是只支持 ASCII 字符集的,那么你的注释就会全变成黑框
sadfQED2
2022-10-15 12:40:24 +08:00
我提出中文注释会导致乱码问题。你们难道用的记事本写代码吗?这年头还有注释会出乱码的问题?

我待会好多团队,代码注释都是写中文。写英语怕不是为了装逼?一个中国团队,又没外国人,你写毛英语啊。写拼音?你是想找打?
9ine
2022-10-15 12:43:49 +08:00
中文注释乱码问题没有遇到过。倒是和英文字体不等宽看得强迫症有点不适...合适的场景一般都用英文。
Laobai
2022-10-15 12:48:32 +08:00
都写中文,没有乱码问题啊
shijingshijing
2022-10-15 12:50:35 +08:00
@chenshun00 碰到过特定软件的 Python 测试脚本中,注释包含了中文字符[,] 跑的时候直接退出了,好一顿 debug
leonshaw
2022-10-15 12:53:40 +08:00
不用中文,输入法切来切去麻烦,而且不少变量名、关键字、不好翻的术语很容易变成中英夹杂不伦不类。
star9029
2022-10-15 13:02:24 +08:00
c++ 用中文注释有几率编译不过
dcsuibian
2022-10-15 13:02:48 +08:00
我写的中文注释,毕竟看的人是中国人。

编码基本全都是直接 UTF-8 。
只有.propreties 配置文件(默认的 ISO-8859-1 )和 powershell 脚本文件中不使用中文注释。
buermo
2022-10-15 13:03:06 +08:00
中文注释经常写的啊
拼音注释比较忍不了
james2013
2022-10-15 13:07:33 +08:00
中文注释导致乱码,我觉得只有初级开发才有这个问题
我写了这么久,在 window 上无非是文件编码不对导致乱码,现在 ide 默认特定文件编码,比如 utf-8 ,只有垃圾开发才会特意在项目里用多种文件编码
如果不是外企和有特定需求,我觉得绝大部分写中文注释更好
dustynight
2022-10-15 13:10:52 +08:00
个人习惯写英文,后来被要求写中文。这个我觉得整个团队有共识就行,没什么好纠结的。
FrankFang128
2022-10-15 13:15:40 +08:00
GB2312 、GBK 时代的 CTO 没用过 UTF8 吗?
wonderfulcxm
2022-10-15 13:21:19 +08:00
我是混写,一般写英文,如果太复杂我表达不好就换中文…反正也就我自己看🙄️
bthulu
2022-10-15 13:23:58 +08:00
我们都是中文转成 BASE64, IDE 插件自动回转到中文, 既不会有乱码问题, 也是中文容易看懂

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

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

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

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

© 2021 V2EX