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

[naijoag]

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

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

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

大家怎么看

[callv]

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

[maddot]

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

[BiChengfei]

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

[sleepyfevniv]

我写注释和 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]

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