讨论一下，代码不写注释，算不算对自己的一种保护？

[oldmanong]

这几天接手离职同事的交接代码，几个项目都是除了打 log 外无任何非代码内容，0 注释

哥们儿是我们的主程，从老板到周边相关同事都口碑甚佳，模范员工。之前我看过他的接口代码就发现没注释，这次算彻底了解

他交接快一个月，所有接代码的人都比较困难，总是需要他讲。反过来对外人的印象是，更觉得他离职可惜，更觉得他很重要，我们老板也觉得我们离不开他

从客观上，不写代码确实是提升了他自己的价值

[qingmei2]

不写注释和保护自己有什么关系？

提离职 -> 代码交接 -> 别人看不懂你的代码 -> boss 觉得你不可或缺 -> 可是你已经走了呀。

已离职 -> 求职 -> 难以理解不可读的代码 -> 不好的编程习惯 -> 面试被 pass

这种所谓 “对自己的保护” 究竟体现在哪了呢？我确实无法理解。

PS: 当然你说其实个人能力很强，编程习惯也很好，自己个人项目也写注释，但公司的代码我就不写注释，那我确实没办法。

[HENQIGUAI]

#19 这个笑死了，必备编码规范呐

[nanoha]

别人写的代码 我感觉看注释和直接看代码理解速度都一样慢

[mushishi]

基本上写流程注释和重要方法的注释，其他的基本都不写了。

[iasuna]

没人会因为这种莫名其妙的小聪明觉得另一个人很重要

因为大家都不傻 你觉得你都看透了 所有其他人也一样看透了

[RJH]

这东西就跟有些人会提倡写不可维护的代码一样。

[fancy111]

没什么保护不保护的，你看不懂别人的代表技术不到位。
另外我是比较懒的，能不写的就不写，如果是要给别人接手，我还是会给他一份手册的，但是不会写到每一行注释。
其实这根本不算什么，当年给别人改东西发来的都是直接一套系统，什么都没说明，都要重写。

[thebayarea]

通过不写代码注释等手段使自己经手的代码, 项目除了自己以外的人难以接手, 维护来提高自己的"难以(不可)替代性", 这是小聪明啦, 解决此问题的方法很简单, 老板找一个信得过的人当技术总监, 由技术总监来 code review

[SkyCity4NJ]

习惯很重要，何况是个好习惯呢：）

[zy445566]

代码写得好，bug 少，看起来就像一个闲人
注释多，代码清晰，任何人接手都非常方便，看起来谁都可以替代
代码写得烂，每天风风火火改 bug，各种救火，解决各种线上重大问题，于是顺理成章成为公司亮眼人才
代码乱的只有自己能看懂，公司不可替代的重要人才

[Orenoid]

愣是把缺乏职业素养的行为说得如此冠冕堂皇

[islandev]

善战者 无赫赫之功

[wangchonglie]

在一定程度上算是, 特别是在代码不规范的小公司里面。但是如果我们要向更高的层次发展, 不应该在乎一时的得失。

[wly19960911]

我有时候想写注释，可是最后不少东西除了实体类字段含义，我就写不了什么注释，一眼看过去明摆着意思的方法名、局部变量名、类型，就知道什么意思，只能说还没有接触复杂的东西

[jsjgjbzhang]

这事不能细说

[annielong]

那种好几行的代码最后精简压缩成一行的没注释还真不好看懂

[pastgift]

不是对自己的保护，是对自己的不负责任

我从来都是把文档 /注释写全，
上一次离职的时候，交接的时候连续讲代码讲了 2 个 8 小时，另外还补了一份至少一万字的说明文档，
从架构设计，历史沿革，可能存在的坑，如何处理新需求，可能存在的前后需求冲突全写明白了才走的。

后来新公司不是很如意，联系了之前的老板，然后直接回去了，
大家都很欢迎，之前的项目同事也早就完美接手并且没有任何问题

藏着掖着或许可以让你一时看似风光，有谈判权，但这只是「过去」，价值不高，
人家放弃代码直接重写说不定就几个星期的事情，那样你留下的评价就是「被替代者」，
所以并不牢靠

把所有的东西都放台面上讲清楚了，别人还认可才是真牢靠，
因为只有这样人家对你的认可是基于「将来」的，
将来的事情，可大可小，想象力无限大

[charlie21]

你们公司很奇怪阿

在我们这里
不写注释的程序员会直接被开除，比如 入职两周 一句注释没写过 那么会直接被开除

你们是怎么长大

[charlie21]

这是写在合同里的，“写出可维护的代码”，如果我不执行合同，那么如果公司觉得自己完全有理由也不执行合同，甚至 给来个 996，what should I say ?

突然明白了人们在 996 面前的软弱性从哪里来

[InkAndBanner]

@gimp 哈哈哈哈哈哈笑死我了