以前很难理解老程序员不写注释，不写文档，代码不规范，命名不规范。现在开始懂了。。。

[jeremylai]

以前接手别人写的代码，到老员工代码，一个注释都没有，运气好的话，有人给你解释以前的业务逻辑，或者给你看以前的文档。要是运气不好的话，只能自己慢慢琢磨了。

后面写注释，命名规范，代码规范，写文档。开发也花了更多的时间。

后面想想，代码的可读性越强，你的可替代性不也是越强吗？花更多的时间，优化自己。

[karmaisbitch]

复杂业务还是得写一点注释，经常过个半年回来看代码都忘了当初为啥要写这一段

[jorneyr]

但行好事，莫问前程。

[jeremylai]

@karmaisbitch 就是更多的是为了自己考虑，少为公司考虑，不然到时候就容易的开了

[yuancoder]

大部分情况下看不懂代码，并不是真的看不懂，而是不知道为什么这么写。
这跟写不写注释关系不大，如果注释只是在描述这段代码在干什么，过一段时间后，还是不知道为什么这么写。

[ghostben]

说起来之前写了一个 vscode 的插件，作用就是在本地对代码进行注释，只有自己电脑才能看到。感觉是不是也有不少人有这个需要？

[AlexHsu]

写文档注释这种事就是将心比心的事儿 正常开发的工时至少的给出一半来写文档 不给时间自然就不写 没什么可说的

[lessMonologue]

@ghostben 老哥发出来吧，刚需。目前是通过 bookmark 功能来用的

[ZSeptember]

虽然但是，代码写的烂，可替代性还是强，该毕业还是得毕业。

[changnet]

对于工作了 10 多年，有那么一点点管理经验的我，是不认同这个观点的。

凡是不定注释，代码不规范的在我眼里都是工作能力不行的，绩效不会很高，工资、职位提升也很有限。如果要开人，第一个开的就是这种人。

代码是评价一个程序员最直接的东西了，你丢给别人一堆垃圾，期望别人对你大加赞赏，升职加薪？你觉得这逻辑走得通么。故意这么搞，最终就是落得人走了，名声在同事里也不好，领导觉得能力也不行。

开发时间太紧，需求频繁变更导致代码可读性不好，这还说得过去。但你至少写出一些工整，规范的代码给别人看，让别人知道你的能力是很不错的啊，这才有可能给别人留好印象，无论是升职加薪，还是以后介绍个工作，内推一下，都有可能。

你如果觉得公司给的钱不够多，那你可以慢点干，出的活少一点，但至少活还是干得漂亮的。或者你直接跳到个给的钱多的公司，那也能理解。

不要迷信什么不可替代，程序员 99.99%的活都是给钱就有人能干。那些代码写得工整规范的程序员也能干，无非就是又跑到某某论坛发个帖子大骂前一个老员工留下一堆垃圾。

对老板来说，开人的时候压根没想过你活干得怎么样，人家是从成本核算来开人的，好的不好的都开了

[dqzcwxb]

[yaphets666]

@changnet 问下大佬，你们团队是规定所有代码都写注释吗？我没有在特别规范的团队干过，想了解下

[jeremylai]

@changnet 如果公司按照代码规范，注释来做评定绩效、工资的参考的话，那我肯定会注意。问题是我公司不是呀，既然不是，那为啥要这样做

[changnet]

@yaphets666 我们公司做得并不是很好。规范有要求要写注释。但有些人不写，也没有强制的措施，公司没有 svn hook 或者 ci 之类的东西来做检查。只是偶尔看到会口头说一下

[tediorelee]

像我们公司不允许随便写注释的有没有，除非涉及到特殊的业务需要解释

[jeremylai]

@changnet 既然没有强制，只是偶尔说一下，那多做了，为了你的理想工作吗？如果只是你个人主观意愿，没有回报，一次两次没啥，经常这样子，不就是欺负老实人吗

[aliveyang]

人的问题，有些人不讲究，有些人不将就

[changnet]

@jeremylai 你不这样做，怎么培养你的编码习惯，怎么提升你的编码质量？难道说在公司写 5 天垃圾代码，周末 2 天就按自己的规范写好代码，能分得这么清？

你在公司不好好写，以后你的同事跳槽了，敢内推你去再做一次同事吗？你的同事出去创业了，看到你代码一团糟，敢带你吗？

你这不是自己坑自己么。你对当前公司不满，有很多种方式可以处理，为什么选择这么一种来坑自己。你觉得对公司有什么损失吗？对公司而言只要代码能跑，钱赚到就完事，你同事多加班两小时去整理你的代码，对公司来说不算事。

[myselflove8090]

不要迷信什么不可替代，程序员 99.99%的活都是给钱就有人能干。。。。。。。。。

[Felldeadbird]

楼主错误理解，走火入魔。

代码可读性强不代表可替代性高啊。你说 linux 的代码可读写怎么样？

老板铁了心要优化你，后面的人接手只要花时间一样可以读清里面的逻辑。

你想想你一个人把公司打理得规划整齐。你被裁了后，后人可不一定有你这般水平的。到时候要试错 N 次 都不一定解决到。

[myselflove8090]

想起国外那哥子上班外包给中国人的事。。