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

2023-03-07 14:07:43 +08:00
 jeremylai

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

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

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

19616 次点击
所在节点    程序员
124 条回复
dcsite
2023-03-08 00:27:33 +08:00
@8355

出发点不同,写注释和文档的热情肯定也不一样。就拿开源软件来说,有的尽量文档注释特别细,有的没有注释逻辑还特别绕,不能说谁对谁错,都有自己的目的……

写的代码太简洁好用,下场就是有你没你都行;写的代码是天书,大家虽然心里骂你,还得看你脸色行事:)

就像你说的,看得太多了,懂的都懂。
dayeye2006199
2023-03-08 01:41:11 +08:00
懂了,k8s 这种 i 项目注释文档都很齐全,所以我上我也行,我也能做 core contributor !
jadec0der
2023-03-08 06:49:39 +08:00
我也工作快十年了,从外包公司一路干到美国的大厂。据我观察,工作能力和前途大部分时候是正相关的。

一类是工作非常出色的人,你明显感觉他在这个公司鹤立鸡群,他经手的代码都很漂亮,如果要转给别人做,接手的人都会表示学到了。他们不担心被替代,反而公司会担心他们跳槽,但最后遇到好机会他们都跳槽走了。

另一类是很会混日子的人,同事不想和他们合作,PM 会避免把需求交到他们手上。缺人的时候公司不会动他,但是市场转冷的时候首先被裁的是这些人。

至于你说的工作做的不好,但是特别会刷题面试的人,我也遇到过很多,从小公司里看,是一个干活不好的同事靠刷题跳进大厂,工资翻倍的故事。从大厂里看则是面试失败,招进来一个光会说不干活的人,如果实在太差还要在试用期结束前劝退。毕竟如果工作能力不行,在什么公司里的发展都有限。
8355
2023-03-08 06:57:01 +08:00
@dcsite #81 开源软件大多是为爱发电,是真正自己想干和热爱的事儿,而公司的项目更多的是糊口,不能想怎么干就怎么干,还得考虑团队能力 /后序维护的人 /内部规范 /为业务未来可能存在的变动留下冗余扩展接口 /救火 bug 的临时修堵等等,这些可能都会让代码变的不再极致。
开源项目绝大部分应该都是作者自己维护,了解所有代码和掌控未来的发展趋势一切东西相对确定不可控因素会大大减少,可能花 5 天 10 天时间研究一个算法或者架构能让性能提升 10%,这对自己十分有价值,对公司来说你花 5 天 10 天研究这个还不如多迭代几个版本写点新功能来的实在,只有业务量足够大特别需要这 10%性能的企业才会足够重视这个行为,但是绝大多数人是进不了这种公司或者到不了这种公司的这个岗位。
murmur
2023-03-08 08:08:15 +08:00
@Felldeadbird 开源的项目能跟商业屎坑项目比,没时间要求各种 pr 各种审查,等到了工作就是要求上线时间,你无论如何都得给我整出来来

那就得埋屎坑
rm0gang0rf
2023-03-08 08:15:00 +08:00
可读性和文档有啥关系。。注释不仅仅是为了代码还有逻辑
codingbody
2023-03-08 08:18:12 +08:00
看写的是否是有效注释吧,有的老哥写的不是注释,是废话,为了写注释而写注释。
Promtheus
2023-03-08 08:45:24 +08:00
的确啊 代码写的再优雅也没人懂,只要功能实现了就行了。
Aindy
2023-03-08 08:47:53 +08:00
关键看人,我自己写过的代码,即使过了一年多再来看,仍然好修复跟扩展(即使注释不全的情况下)。 但是改别人的东西真的要我老命
theprimone
2023-03-08 08:50:56 +08:00
《代码整洁之道》
mqtdut1
2023-03-08 08:54:35 +08:00
注释是写给自己看的,不是给别人看的
M003
2023-03-08 09:06:19 +08:00
能跑起来就行.还要什么自行车.
老板要的敏捷开发,甚至以为跟你讲需求的同时,你代码已经写完了.
dcsuibian
2023-03-08 09:06:51 +08:00
靠怀孕能留住男人么
magese
2023-03-08 09:09:15 +08:00
工作 6 年了,不管别人写不写注释,我是一定要写的,无论时间紧不紧。

至少是每个方法函数上都会写明这个方法是做啥的,出参和入参是啥,实际写起来也花不了几分钟。
zimhy
2023-03-08 09:16:33 +08:00
之前小组领导搞事情,要求方法代码圈复杂度 20 以下,类 120 以下。于是状态机+设计模式+DDD 一通操作,成功达标,然后这些彻底没人敢动我写的代码了,滥用设计模式写出来的完全没有可读性。
代码复杂度只能被隐藏,不能被消除。
fields
2023-03-08 09:17:16 +08:00
@j717273419 那你是不是很累
MEIerer
2023-03-08 09:20:08 +08:00
在国内一些私企,写得好也是罪
vazo
2023-03-08 09:26:58 +08:00
以前可能行,现在有 ai 可以重构注释,怕是不会增加你的不可替代性哦.
fenglangjuxu
2023-03-08 09:30:38 +08:00
作为很老的员工 我不写注释 是觉得 写了之后 感觉代码就乱了(复杂逻辑我会写一点注释) 个人不喜欢那些没用注释掉的代码(觉得就是死尸) 也不喜欢每一行都加注释的 还不喜欢简单的逻辑 也写一堆注释的

被人替代不替代,和这个没啥关系吧。
akring
2023-03-08 09:48:41 +08:00
@vagranth #11 俗称劣币驱逐良币,但是大环境如此,公司得到了他们想得到的结果

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

https://tanronggui.xyz/t/921889

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

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

© 2021 V2EX