甲方爸爸们请看过来:代码用中文命名,真香!

原创
2020/07/29 10:44
阅读数 223

刚看到的几位乙方的心得,不敢独享,节选如下:

仅仅是变量名,库名,类名,文档使用中文,在国内跟其他公司,特别是非程序公司进行项目交付,相对英文,节省了巨量精力

用中文做变量名包名api名让我文档直接单刀直入省了巨量精力

业务员甲方拿到文档和代码bb次数少了很多,交流很快,业务进度快,这就叫精力,和金钱

因为文档,需求,业务代码解释上来回扯皮 反复修改和教导解释。毕竟甲方是爸爸。而代码是公司积累的,基础部分可以重复使用(现在也用中文重写了一边),再根据每个客户写不少的 业务代码 。

中文输入,现在输入法都支持标点用英文,中文输入,完全不需要切换输入法,还有所谓的输入量, 是同样全含义的英文标识符,和中文标识符对比,能少一半以上长度,如果英文不是用驼峰而是下划线,省的更多,如果用双拼,击键量也能骤减,现在有答主提供的VScode 中文补全插件 【注:本人并非插件主创,仅参与了发布】,更方便了(相对以前)。关于看过去累不累,我自觉还可以,组里也觉得还行,反正比驼峰和下划线好看的多,强迫症排版也容易,当然,这是主观感受。

不是没有注释,而是注释只需要像 美国人给美国人写一样,而不用去再进行照顾,在原先正常的注释外 再额外写一些令人烦的注释和文档。(一次写了40页文档,甲方觉得后面维护总来问不太行,让扩到100页以上,把所有都给翻译然后补上,不然不给验过,这情况你没碰见过吧,头皮发麻好吗)

如果现有库类和文档全是中文的话,中国人遇到的问题会少很多,加速调包是肯定的。中文命名当然有问题,中文在极短构词和缩写规范上明显不如拉丁字母,就像在完整含义表述上拉丁字母若不想变得超长一串 就得缩写。不过组里要求完整含义,所以用中文反而让我觉得很爽。

我再次说明,既然用了中文,肯定要把信息熵优势发挥到最大,组里是不允许缩写中文的,缩写中文我为什么不用英文去缩?图的就是一眼扫过去明明白白。

上中文一是为了业务快,二是为了少无效沟通(例:微信上问标识符含义(文档未提及的))。 甲方真觉得中文可以,他们不是专业弄代码的,接收,验完功能,交差就可以打款了,公司不大,效率第一,我可不想996。

甲乙双方都省事,何乐不为?


本文分享自微信公众号 - 用中文编程(CodeInChinese)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。

展开阅读全文
加载中
点击引领话题📣 发布并加入讨论🔥
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部