我现在码着代码 就像是一台机器

[unique]

公司开发了一年多的代码，代码行数14W+
换了领导后突然说要给代码都加上注释，刚来公司的时候没有这个规定。
当时也写了注释，但不是很规范，现在要求在一个月的时间里让我一个人写完所有注释。
现在码着这些注释的我就像是一台机器努力运行着，心里当然有些委屈。
我怎么能摊上这种事儿呢，也是醉了。。公司不大，要求蛮多，不知道其他同事是如果，反正开发部我的机械键盘噼里啪啦的响个不停，我越听越来气。

[zg_gz]

你说我的函数名和参数名斗士 self-explanation 不需要注释

[unique]

@zg_gz 公司就担心你哪天离职了别人看不懂代码什么的

[tini28]

哈哈，注释也看不懂。害怕离职就让两个以上的人做同一份工作，那样公司的支出也成倍增加

[235777178]

其实也不算很不合理。

产品一样需要补充各种文档、流程。

尽量养成在开发过程中写注释的好习惯才是根本。

[unique]

@235777178 我也并没有说公司提出这个不合理；但对于个人而言，我有开发工作要做，抽出业余的时间去写注释，你给我的时间是不够的，而且工程里别人的代码注释也是自己写（如果是你会感到有些不公平），很明显我要拼命的写这些注释，可能还要为这个事情加班，算到自己头上总觉得很不爽。

[mingzhi]

写好函数名比注释更重要吧。。。

[Codist]

每月1w行么，写这么多

[unique]

@Codist 我写的自己都快懵了

[zhicheng]

没有合不合理，而是在于需要不需要。
比如我写的

print_hello_world() {
print 'hello,world';
}

某天老板让我给这个函数加上注释，那我必然会不爽。

[unique]

@zhicheng 来我们公司 就会让你这么干 全部加上注释

[codeyung]

定义函数名就好吧 复杂业务注释 合理既可 太计较真心没卵用

[zhicheng]

@unique 这个在国内其实还挺常见的。
外行领导内行，自己人说什么老板都不会信。外人随便说一嘴，老板都会当成圣纸一样。心理作用尔已。

[unique]

@codeyung 同意你的说法，但是我们这一层的民工就像是军人执行命令一样，No permission

[unique]

@zhicheng 我认为互联网公司不应该有这种风气 又不是国企，初创企业

[laoyur]

“反正开发部我的机械键盘噼里啪啦的响个不停，我越听越来气。”——这句好有喜感

回到正题，如果别人的代码也要你加注释，然后这一个月都是在干这破事，换我我也生气

[unique]

@laoyur T.T当个程序员容易吗

[zhicheng]

@unique 有人的地方就会有这样的问题。
比如我们用阿里云好好的，就会有人跟老板说青云靠谱儿。比如我们用又拍云好好的，就会有人跟老板说七牛靠谱儿。这种人比比皆是，他们没有能力去做一些真正的事情，只能像古代太监一样，不停的给人吹耳边风。

[unique]

@zhicheng 当然我们公司没有这种问题，但是好像总给人感觉下面人就干活，领导说什么就是什么，但是据我来看领导力并不如何，早晚会走，等待时机而已。。

[xjl]

好的代码 根本就不需要注释。

[AmberBlack]

楼主加油。