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

2020-03-11 11:27:25 +08:00
 oldmanong

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

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

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

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

13074 次点击
所在节点    问与答
120 条回复
hbolive
2020-03-11 12:26:14 +08:00
公司 CTO 不行或者没 CTO。。
RubyJack
2020-03-11 12:33:26 +08:00
自己写代码, 我都抽象真是优雅,实现真是精致, 要什么注释,我这艺术般的代码就是最好的注释

看别人代码, 这都什么 jb,还不写注释,sb
Perry
2020-03-11 12:34:55 +08:00
Code Review 去哪了?
Building
2020-03-11 12:41:13 +08:00
有些注释写的...还不如没有。
Vegetable
2020-03-11 12:47:02 +08:00
kbyyd24
2020-03-11 12:51:38 +08:00
我们公司的人都不写注释,因为没人看,大家都是直接看代码,因为代码即文档。只有很难用代码表达意图的时候,才会有注释
whileFalse
2020-03-11 12:52:12 +08:00
0 注释不好。

我的代码注释很少,在复杂的部分有一些注释。
那些么有注释的地方,代码本身就是注释了。
chroming
2020-03-11 12:55:21 +08:00
我觉得不是,不说一段时间之后自己都看不懂的问题,不管是被开除还是自己主动辞职,也只有别人真正开始接手的时候才知道代码不容易看懂,这已经是确定要走的状态了,领导加钱留的可能性不高。
另外别人看不懂要经常问,如果是架构设计的很优秀因为接手人水平不足难以看懂会觉得他厉害,但是如果是不写注释或者逻辑故意写的复杂,接手的人只会在心里骂他傻 X
NeinChn
2020-03-11 12:56:06 +08:00
业务代码不写注释也挺正常的吧,但是我会习惯把对应的业务开发需求文档贴到对应的业务代码上面,只要知道解决的问题是什么,大不了就是重写。

知道要做什么就很好办,要是连当初做的事情也不知道,只能从代码反推,那就凉凉了。
Wicked
2020-03-11 12:58:36 +08:00
1. 该写注释的地方而故意不写,那是挖坑埋自己
2. 再说了,作为主程,别人看不懂写出 bug,还不是算到自己头上…
3. 通常,作为主程,都是恨不得底下的人个个独当一面,自己躺着派派工单就把钱拿了,哪会坑自己人的
chroming
2020-03-11 13:00:18 +08:00
楼主的问题关键是“不写注释就不容易理解的代码却不写注释”等这类主观上不想让别人理解代码的行为是不是对自己的保护,而不是“不写注释是不是有问题”,可能楼主同事没有这种主观想法,不过不影响楼主的问题
icyalala
2020-03-11 13:04:18 +08:00
楼主认为 "不写注释" 让外人印象离不开他,从而提升自己的价值,
那么请问,只用我自己懂的语言和框架算不算呢?
排挤掉能干的员工只保留我自己算不算呢?
造一些不稳定的坑然后自己来填算不算呢?

"让外人印象离不开",这肯定不是所谓"价值"。。
mazyi
2020-03-11 13:09:31 +08:00
代码是自解释的,只应该写为什么,而不是写干什么。所以如果要达到楼主认为的注释,写一写干什么就行了。
asukanoir
2020-03-11 13:13:48 +08:00
对于我自己来说,如果我不写注释的代码几个月之后还能看懂的话,那说明这代码不写大家也都能懂。如果我几个月之后看不懂了的话,一定会拍一下大腿骂道:TM 的当时为什么不写注释。所以我在比较难懂的地方都会多少写上几句注释,我还想好好干。。。
dd0754
2020-03-11 13:39:34 +08:00
我就从来不写注释。。。
mouyase
2020-03-11 13:40:43 +08:00
不写修饰就是代码质量不好,不需要其它解释
loading
2020-03-11 13:40:55 +08:00
那就重构他的代码,他不走,没注释的代码会越来越多。
yhxx
2020-03-11 13:44:21 +08:00
有个前端同事经历过一样的问题
他和一个后端一起负责同一个重要项目,前端部分文档注释使用手册之类的写的特别完善,后端什么都没有,遇到问题所有人都只能找这个后端解决,年底了后端作为优秀员工上台接受表彰,大家都觉得后端是这方面的专家,不可或缺,反倒前端随时可以被替代
chanchan
2020-03-11 13:45:39 +08:00
@gimp 企业开发经典入门读物 😄
sudoz
2020-03-11 13:47:10 +08:00
代码可读性是衡量工程师水平的一项能力

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/651797

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX