commit 信息和代码注释要求写中文

[naijoag]

起因是 我开发的一个版本中出现了一个稍微大点的 bug 数据未根据用户做隔离 b 端系统 自己内部使用

后面领导要求提 mr 给项目负责人 review 然后项目负责人要求我 commit 信息和代码里面的注释都要写中文。为了他能看懂。。

从业以来 commit 信息一直写的英文 一个是自己喜欢英文 二来可以锻炼自己的英文书面表达 三来我感觉比写中文言简意赅 当时也没反驳 想着迁就下算了 为了他人着想嘛 但又感觉有点那啥

大家怎么看

我书面英文不差 我说了是练习英文：保持英文思维 我不需要学什么 再说没人指正 也学不到什么 只是说保持这种英文思维 google 的时候你没点书面英文能力 能快速精确搜索出内容吗
优越感吧 我感觉确实有 我比较自卑 英文算是自己的强项 从小学到大学都是名列前茅的 毕业后在提高听说方面
你自己喜欢的东西 在意的东西 被别人剥夺了 心理会没点感受吗 不知道为什么这么多喷我的

[alanying]

团队大多数人喜欢中文，领导又偏向中文的话，用英文会很“突兀”

[naijoag]

@alanying 领导写代码也是英文 项目负责人要求的我写中文

[sunwei0325]

中文挺好的啊, 按规范写 commit, 用工具直接生成 changelog

[sagaxu]

@naijoag 让领导和项目负责人开会，他们定一个规范给你

[naijoag]

@sagaxu 我倒希望我们有个规范 现在接口啥的都没规范哈哈

[naijoag]

是的 要是有规范的话 我遵守没话说

[dcsuibian]

如果 ①不是国际化开源项目 ②团队内部都是中国人 （ ③偏国内环境的业务 ），那这个要求正常的不能再正常了
又不是变量或方法名用拼音，commit 信息和注释本身就是给人看的，那么中文应该是最佳选择了

你提的三个因素，前两个跟公司没有关系，第三个也是你的个人看法

[jessun1990]

在这种情况下，中英文都写上，绝对不会有错。

[JCZ2MkKb5S8ZX9pq]

没啥好纠结的，既然还在练书面表达的阶段，那英文水平很可能还会进步变化吧，没准过几个月看自己写的英文都觉得别扭或者用词不准表意不清呢。
项目还是要从长计议的，还是要考虑后续接手项目的人。

@sunwei0325 commit 生成 changelog 有啥工具推荐嘛，听着有点意思。

[villivateur]

写中文没有任何问题，注释是给人看的，除非你去当负责人

[ttgo]

不能忍，必须润。

[naijoag]

算了 就抱怨下吧 也没啥意义 迁就下吧为了让接手的人能看得懂 下次遇见这样 直接叫制定规范吧 没规范不改[doge]

[Buges]

你可以换 Linux ，现在包括 vscode 在内的所有 electron 应用和 chromium 在 wayland 下还不支持中文输入法，这样就有借口只写英文了。

[lzgshsj]

怎么说呢，首先看团队规范，如果没有规范的话，有些人写英文有些人写中文，会显得比较乱。最好协商好要么全中文，要么全英文。

[MrSheng]

一直用中文，并且 IDE 也是汉化版本。
来吧，秀优越的可以开喷了。

[wunonglin]

是开源代码吗？
是有海外人员参与吗？

都不是的话在 commit 里写中文有啥问题？？又没叫你用中文写代码

[timpaik]

@Buges #13 早就能用中文输入法了。

[noyidoit]

@jessun1990 我试过，超 50 字不让写[doge]

[Buges]

@timpaik 并不能，我用了好久一直没发现不能输入中文，最近才发现不能用，然后搜到了老 k 的博客 https://www.csslayer.info/wordpress/fcitx-dev/chrome-state-of-input-method-on-wayland/

[Jooooooooo]

谁给你发工资谁说了算.

[Vegetable]

我见过很多人，硬是要写英文，关键是这玩意不仅书写有门槛，阅读也有门槛。
最后写出来的英文中国人和外国人都看不懂。

而且很多项目中，别说英文了，连中文术语都没统一，什么是订单什么是账单都有人理解错，还英文呢？

我觉得纯中文的办公环境就应该用中文，很多变量枚举值也会考虑适当使用中文。代码写出来更多时候是用来看的，如果你发现某些地方用中文能更方便阅读，减少跳来跳去的次数，中文又有什么不好呢？

[salor]

“你这种情况是要加钱的”

[dangyuluo]

项目只有中国人参加的话写中文没什么问题，我们公司很多日本人还用日语写 commit message 呢，当然是他们组内部的 repo

[vagranth]

这算什么要求？太扯了吧。这种要求让他发公开邮件说明。

[JaguarJack]

@MrSheng 其实汉化之后反而看不懂了😂，还需要一段时间适应。

[chenyu0532]

写中文任何人都看得懂，写英文你就不怕遇到个英文好的挑语法毛病么。。
又不是上 guthub ，没必要

[satoru]

我想提交信息和注释跟其他写作没有太大区别，重要的是让读者能看明白。
对方表示他看不懂，可能是他英文不好，但也可能是你“锻炼”中的英文表达不清楚，如果换成中文就能提升沟通效率何乐而不为。
关于锻炼英文书面表达，我觉得跟各种刻意训练一样，反馈是很重要的，像你描述的场景我看不出有太有效的反馈，所以锻炼的效率也应该很低。

[jworg]

英文都看不懂的项目负责人能看懂代码吗，楼主心中有疙瘩的应该是这个地方，要是注释和代码不一致怎么办，这个所谓的项目负责人能 review 出来吗

[Goooooos]

你适合找个外企工作，不但写，日常交流也能锻炼

[wxsm]

> 一个是自己喜欢英文 二来可以锻炼自己的英文书面表达 三来我感觉比写中文言简意赅

这些都是你的主观看法，你喜欢英文，你想锻炼自己，你感觉英文比中文言简意赅。你站在一个开发者的角度思考了这个问题。那么换位思考一下，对于领导&整个团队来说，什么是更重要的呢？

我觉得注释和提交信息清晰明了，大家可以一眼看懂，减少不必要沟通成本，减少可能因为英文不好而导致的误会，这可能更重要一些。

[youstu]

@Buges 我用 ubuntu 22.04 ，图形后端是 wayland ，chrome 上中文输入好好的

[Kaier]

中英文都写不就得了~

[digimoon]

你发的这个帖子为什么不是英文？

[littlewing]

“为了他能看懂。。”
是因为项目负责人不懂英语还是因为你写的英语别人看不懂，如果是前者，直接跑路

[murmur]

中国团队中国产品写英文的注释不奇怪么

[Vindroid]

自己英语水平有限，有些复杂的 bug 描述用英文不一定能表达清楚，所以我对于一两句话就能描述清楚的用英文，复杂的用中文

[dinghmcn]

中国空间站都用中文了，对内的项目用中文不是很自然的选择吗？

[night98]

你提的三条都是对你个人有利，注释写出来是团队协作，你是领导你怎么选？

[masterclock]

全中国人团队吗？为什么要写英文？写中文感觉那啥了？ low ？恶心？下贱？

[maddot]

对自己的英文这么自信？

团队都是中国人并且也是国内的公司，要求中文才是正常的好么，写英文是你不正常

我曾经在一个国内的要求写英文文档的团队，里面有博士，多数是研究生以上的，那英文写得真是让人不敢恭维，呵呵

[gzyguy]

不知道为啥要写英文，追求国际化？
commit 信息不应该团队内人人秒读懂吗，愣是写英文不会是看老外项目看多了不自信了吧 [狗头]

[maddot]

在代码注释里锻炼自己的英文能力？？这种想法理解不了接受不了

[BiChengfei]

公司付钱给你，工作上的事，当然要服从公司规定

[sleepybear1113]

我写注释和 commit 都是中文的，为的就是能一眼看懂。写英文我自己还得翻译转一道，无故添加理解成本，有时候可能理解出错。而且有时候需要看啥时候写的那个功能的时候，中文一目了然。

[sunwei0325]

@JCZ2MkKb5S8ZX9pq 我们用的是这个工具, 根据 commit 生成 changelog, 可以参考

https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-cli

[fernandoxu]

太逗了这帖子，纯国内公司国内团队，写英文的意义是啥？笑死人，有不是变量名函数名

[Haixiang]

不懂全员中国人里为什么要写英文 commit 。

自己看过一些中式英文的 Commit 和注释，经常看到乱用时态、单复数、拼写错误、冠词不对、语法不通顺等等一堆问题。这些小毛病不会让人觉得你写英文很牛，只会觉得你不专业。

如果要非要锻炼英文，自己去 Medium 写英文博客就可以了，要锻炼口语表达，自己录一个 YouTube 放一去被别人喷一喷都比写英文 commit 锻炼来得好。

[daliusu]

不知道这有什么好纠结的，如果你的团队英文确实水平不太好，或者大家就想看中文，那你就用中文不就行了，你强行用英文别人也不一定看得懂也不一定看得舒服。如果你接受不了这件事情，早点离职对大家都好

[monkeylmj]

国内团队中文 commit 没任何毛病，不会有理解上的毛病。 楼主不要因为自己的喜好，不接受团队的观点，自己不一定是对的

[cmdOptionKana]

中国人写，给中国人看，为什么不用中文？这个道理怎么讲。

[zw1one]

需团队达成共识，然后按规范来。

[neptuno]

中国公司，全员中国程序员为啥不用中文写 commit 信息呀，很多人写的蹩脚英文，还带了很多自己定义的缩写，根本看不懂呀。

[ArthurMarcel]

我觉得符合团队要求，中英文都可以，如果要求统一中文且没有开源国际化合作的场景下，听起来是非常合理的。另 好多人写蹩脚的英文注释不如不写......真的令人迷惑

[fox2081]

你想着“迁就”着别人，有没有想过之前都是别人“迁就”着你

[cominghome]

#7 说得很好，注释、日志都是给人看的，如果没有外籍人士能接触到这类信息，写中文未尝不可；我们部分系统也开始加中文日志了，因为部分告警会推送给非技术人员甚至一些基础岗位如客服，中文更便于大家理解

[guansixu]

楼主写东西都不写标点符号的吗？

[lakehylia]

看来楼主的中文确实不好，通篇看下来就没几个中文符号。估计负责人会对你写的中文描述有意见的。

[NeezerGu]

那我要是觉得想锻炼阿拉伯语呢……

[A555]

需要写注释来锻炼英文能力,还是别写了吧

[xsldebugger]

努力努力换外企吧，因为环境烂，还不允许你上进。以后你连外企都进不了

[xylxAdai]

你给谁看的？只给中国人看的话注释和 commit 信息写中文没啥毛病。
要不然你就换个公司。我觉得这个要求很合理，不是什么迁就的问题，你要明白，你写英文是别人在迁就你。

[potatowish]

我很好奇那么多奇奇怪怪的需求，你怎么用英文写的，难道是拼音吗，没其他意思，就是单纯问问

[cxilife]

想吐槽总是能找到槽点的，要是之前规定是英文，楼主今天个帖子标题可能是： 同事的英文水平不忍直视，XXXXXXXXXXXXXXXXXX 。

[timpaik]

@Buges fctix 不清楚，我使用的是 GNOME + ibus-libpinyin ，没遇到啥兼容性问题

[Rrrrrr]

不要为反抗而反，注释这类东西还是写中文吧。

[Buges]

@timpaik gnome 好像实现了些 workaround ，kde 及其他各种 wm 都不行。

[OnionJuice]

发布该主题的内容为什么不用英文？关于“一个是自己喜欢英文 二来可以锻炼自己的英文书面表达 三来我感觉比写中文言简意赅”，好像没什么说服力啊。

[vone]

我直接不写 /doge

[HENQIGUAI]

你在中国公司和中国人沟通，不写中文？我不理解。。。。

[fxxkgw]

建议写文言文 更言简意赅

[elintwenty]

很多人英文写的都没法读，规范是为了让大家更好的沟通，除非你的项目很国际化或者大家英文水平都很好，否则用英文做注释或提交记录才是真正的影响大家工作效率，总有人以为用英文就是上进，那么英文不好的团队或非国际化大项目就赶快逃吧，这些不适合这样上进的人

[keepeye]

英文言简意赅

请用英文将这句话描述出来，让我看看有多么言简意赅

[ccyu220]

离大谱，看下来不知道是我有问题还是你有问题。

[loryyang]

我们要求都写中文，因为大家英文水平有限
然后换个问题：中文有什么不好？难道逼格太低？

[subpo]

以前买过，感觉还是不划算的，这玩意单独能占半平米地方
没有的时候感觉总是要打印，买了之后反而就没有什么打印需求了。。

[3country]

只写中文注释的路过。。。

[hoythan]

你试试中英双拼？
Fix: any...
修复：某某某问题

[hoythan]

@hoythan 不过英语水平不过关不要尝试，不然被人发现英文语法问题更尴尬。

[hhjswf]

woc ，你这是在工作啊，少在工作中整花活行吗，还美其名曰为他人着想。。。

[Ashore]

写中文呗，起码大家都能看得懂 。不然后后面的人接手你的代码会很难受的

[andy2415]

>一个是自己喜欢英文
用英文发帖更能体现你的喜欢

>二来可以锻炼自己的英文书面表达
用英文发帖更能锻炼书面表达

>三来我感觉比写中文言简意
请将此贴翻译成英文, 我对比一下

[freefcw]

语言是用来沟通的，如果英文能很好的沟通，那么无所谓，用中文写注释和提交日志又怎么样呢

[fpure]

@Vegetable 中国人和外国人都看不懂的英文太真实了😂

[xmt328]

如果团队都是中国人，我觉得这样效率更高

[zjj19950716]

@subpo 串台了？

[xingheng]

我也一直写英文 commit message ，不论是自己的项目还是公司项目。如果公司项目没有 commit message template 的话，我觉得写英文 commit 是完全没有问题的。

阅读理解方面，对自己，首先确认自己的表达是没有问题的，其次是解释清楚了当前 commit 的上下文和改动。对团队，能让别人理解是根本目的，没必要纠结语言问题，更不存在什么优越感。主流编程语言的文档就是英语，别人看不懂是别人的问题。我就没见过用中文搜索技术问题能直达 stack overflow 的，除了 chinese 频道。
强行翻译有时候反而会造成误解，比如苹果 iOS 官方的类 UINavigationController 有人翻译成导航控制器，最开始看到的时候我反应了半天。有些业务名称在最初沟通的时候是用中文，还没有英文叫法，那我会写中文代替，理解为主。

个人偏好：我很少在命令行写中文，因为我非常讨厌频繁切换输入法。我也“被建议”写中文 commit message ，迁就过，后来我没在那儿待很久。

[subpo]

@zjj19950716 #84 诶，我靠

[abctt]

蹩脚英文还是别了吧，时态乱用、介词乱用、语法还不对，那能叫英文吗。

[MiketsuSmasher]

中国人做的项目用英文写注释和提交信息，不管会不会写直接霸王硬上弓，自己都不觉得别扭吗？

[cxe2v]

这年头还有以因为用英语而产生优越感的，哎~
Nowadays, there are people who have a sense of superiority because of using English. Aye~

[bigShrimp8577]

你们 commit 写的都很专业，很标准的吗？我都是随便乱写些关键词的，毕竟还有字数限制，100 个字符，我想输入多点单词都没法子

[czfy]

If your content is meant to be read by someone, make it readable for them.

[SawyerGuo]

中国人的项目用中文写注释有何不可，还用英文写觉得言简意赅，真是搞笑，建议你出国，然后你就可以天天言简意赅了。

[ZHenJ]

中英双语是不是解决了

[ALVC666]

中文就中文了
我写英文纯粹是 ideavim 懒得切回中文。。。懒

[mmdnk]

这是发帖出来丢人的吗？

[liyaoxinchifan]

语言是沟通工具，应该用最高效的方式去用

[zhchyu999]

你觉得用英文更高级么？

[Felix2Yu]

公司招你，是让你解决问题的，你的成果要让全体团队成员理解。而不是花钱请你来自学英语的

[kkzzkk]

写英文注释没问题，但公司要求写中文其实也没问题，我想你觉得不爽的点在于领导要求写中文的理由是为了他自己能看懂吧？不用想那么多，都是打工的，拿钱办事就行了，目光要放长远，他也不会一辈子都是你领导