※ [本文转录自 Tech_Job 看板 #1NZjKqjl ]
作者: randomly (伦敦铁桥垮下来) 看板: Tech_Job
标题: [请益] 强者不需要注解
时间: Wed Jul 20 09:34:41 2016
大家早，
我转发了各位在上篇讨论的结果给我刚退伍的同学，
小弟先代他谢谢各位的回复，
但是...
这件事情居然有后续，我也先建议他赶快开履历重找工作了
他手上那份source code其实
“完全没有注解”
而且听说也是架构不明，各种奇怪的coding方式跟变量命名
还有很多跟实际功能搭不上的function名称
奇怪的coding举例：
int functionX(int data, int Size, int Length)
{
...
functionY(data,Length,Size)
}
int functionY(int data, int Size, int Length)
{
....
}
我光看这段就觉得无言了
code真的很乱的感觉
他说他有问主管为什么code没注解也没有文件
主管说：“强者不需要注解”
作者:
loveices (交大松本润)
2015-07-20 09:39:00你去其他公司也会遇到一样的情况 稍微不顺利就想走 不是一个好的工作态度
作者:
COCOCCC (COCOCCC)
2015-07-20 09:51:00就想办法看懂，然后思考一下如果自己做是不是可以不要
作者: bpq 2015-07-20 09:51:00
楼上肯定不是写软件的,如果工作是在写软件而公司又如此不重视这块,建议快换
作者:
rolleiman (rolleiman)
2015-07-20 10:01:00其实业界的code,很多是这样的，同事如果愿意教你，比自己摸快很多。
作者:
dakkk (我是牛我反刍)
2015-07-20 10:12:00XDDDDDD 直接离职吧
作者:
kong028 (空)
2015-07-20 10:14:00注解很重要啊!
应该是之前离职的恶整老板吧…几万行没注解，function功能是用硬背的喔？
作者:
f124 (....)
2015-07-20 10:22:00我是都写架构注解在笔记本上 离职就带走了...-3-
作者: rockalife (牛奶皮肤安西老爹) 2015-07-20 10:26:00
强者不需要柱柱姊 需要小英
作者:
meowyih (meowyih)
2015-07-20 10:27:00^^^^^^^^^^^^^^^^^^^^^^^^^ 只有几万行的可以
作者: imafox (天杀的狐狸) 2015-07-20 10:36:00
不注解，原作者才有存在的价值
作者:
loloman (吃饱的感觉真好)
2015-07-20 10:43:00薪水要是足以找到真强者，不如全部重新写过算了与其看一个不一定会动要debug半天重新解读还不如自己再写一个自己编排完整好维护的版本
如果他给的薪水 是给强者的薪水 那就埋头干下去啊!
作者:
loloman (吃饱的感觉真好)
2015-07-20 10:45:00其实最大的陷阱还不是不会动，而是动错了你没发现
作者:
VdustR (京)
2015-07-20 10:46:00可读性够高可以不写吧
作者:
kevin28 (嗯？)
2015-07-20 10:50:00看钱的多寡
作者:
iamshiao (CircleHsiao)
2015-07-20 11:00:00不是大侠吃香蕉
作者: badyy (nick) 2015-07-20 11:04:00
痴，不能维护的source才能当一方source阀,不怕失业!
作者:
sweet222 (就是要让你感动)
2015-07-20 11:06:00都嘛可以看懂，但是效率不高，最好有文件
作者: tallhand (苦练才能成为王者) 2015-07-20 11:11:00
因为老板也看不懂，注解错了被发现就丢脸了
作者: laurenceliu (催眠大师 Q'_'Q) 2015-07-20 11:17:00
比乱注解好多惹
作者:
motoman (motoman)
2015-07-20 11:32:00就嘴回去 说 可是我领的是弱者的薪水
作者:
v7q4 ((．)(．)乳剑双修 -|＝＞)
2015-07-20 11:40:00这种浅度思考的烂code 当然不需要注解....
强者不用注解 主管没说错快离职 强者是不会有疑惑的 这间公司太强大了
作者:
ijg (...)
2015-07-20 11:49:00你可以回说“可是你们不是强者”XD
作者:
mlda888 ((╭￣3￣)╭♡ )
2015-07-20 11:56:00爱不需要装乖
作者:
voodist (小虫)
2015-07-20 12:00:00骑驴找马 架构就慢慢摸 要急也是主管急
作者:
Argos (Big doge is watching u)
2015-07-20 12:11:00强者是不需要注解阿 但那是架构和命名好的连注解都是多余的但主管的意思大概是说 强者才能看懂没注解的烂code
作者:
DrTech (竹科管理处网军研发人员)
2015-07-20 12:16:00这样就劝人离职，会很容易换工作吧
强者的确不用注解，前提是程式命名和架构要写的好。而不是要花一大堆时间看懂别人在写什么
作者:
HAKUKE (亚流师)
2015-07-20 12:24:00所以主管的意思应该是"强者不需要(看)注解"?
作者:
elikey (平静充满干劲)
2015-07-20 12:33:00照老板的说法，以后报告就都直接丢data就好不需要整理跟结论，反正强者不需要注解嘛
写的好的确不用注解，但这 case 的确不算好...
作者:
layan (教练我想打球 T_T)
2015-07-20 12:39:00推楼上 主管的意思应该是楼上所说的不过快逃阿
作者:
iLinux (艾林尼克斯)
2015-07-20 12:56:00linux kernel上的注解实在有够多，还不太能使用typedef，谁是强者，自己分辨。
就是专门搞死新人借机说程度不好之类的，老鸟保住饭碗的一种手段啦
作者:
yyc1217 (somo)
2015-07-20 13:10:00谁说强者不需要注解XD 写注解也是给自己看的
出社会久了就知道 选择比努力重要多了 跟错人等于浪费生命
作者:
cat0429 (momo)
2015-07-20 13:21:00以前我英文很烂的时候，也都不写注解的，因为不知道怎么写
作者:
ijg (...)
2015-07-20 13:21:00推楼上看不对就快跑,下一个会更好,一堆人只会傻傻被凹还以为老板会感激你,大概也只有吃x有你的份而已
作者:
ssmmss (冏~~)
2015-07-20 13:26:00跟老板说你是弱者，请老板注解
作者:
mrsix (六本六十六)
2015-07-20 13:36:00这种写法简直违反潮流呀XDDD现在写程式的潮流是命名尽量让人一眼就看明白，这样就不用写那么多注解了。还好不是Perl，如果是Perl的话真的就麻烦了！
强者确实不需要太多无谓的注解，但看这code的命名...
作者: felizzZ 2015-07-20 14:18:00
业界的code很多都这样?? 至少敝公司命名规则好 又有注解
作者:
moon2519 (~X~X~)
2015-07-20 14:23:00学程式不会写注解，也是醉了。
作者: banjmin (HD) 2015-07-20 14:33:00
人肉obfuscater
快逃+1强者写的code指的是不需要多余注解就能看懂的吧XD
作者:
xupmc (台湾老鲜肉)
2015-07-20 14:35:00写程式注解是重点阿 块陶吧
真的只写functionX，鬼知道这是在干嘛，连传的值是什么也没有很清楚，怎么debug
作者:
whipzj (被卒吃)
2015-07-20 15:39:00去github找程式大部分都是有注解 难道他们不是强者？
作者: buper (ymsrc) 2015-07-20 16:09:00
糖，香料，以及美好的事物...再不小心加入functionX，不会注解的飞天颇圭能就诞生啦
作者: XD978 (~QQ~软糖) 2015-07-20 16:10:00
没用goto就算不错了XD
作者: JeremyLin17 (Linsanity) 2015-07-20 16:17:00
注解代表对程式的态度，不写注解只代表懒人，不代表强者，后续做处理也会很没效率
前提是 code style 做好 两者都没做好的是智障
作者:
aaaming (搅屎南帝一灯大湿)
2015-07-20 18:48:00神之code 87变量
作者: giantwinter 2015-07-20 19:00:00
wtf
作者:
now99 (陈在天)
2015-07-20 19:19:00别人需要啊
作者:
Qcloud (Direction)
2015-07-20 19:26:00可惜主管是弱者
作者:
dakkk (我是牛我反刍)
2015-07-20 19:33:00这就像宣告变量用a b c一样
强者不写注解原因是可读性高，很明显这位根本是嘴砲强补充：是 code 本身可读性就很高
作者: catvsdog (我不能活在没有你的程式) 2015-07-20 20:44:00
块陶吧 就算是自己写的扣，没写注解久了都有可能忘记在写什么，何况是看别人的，这主管根本没概念
作者:
Simonfenix (Livingfailure)
2015-07-20 20:47:00天书就是这样来的
作者:
overhead (overhead)
2015-07-20 21:15:00请问那段code是真的写"functionX"这样的function name吗?
作者: ts04953635 (阿G) 2015-07-20 21:56:00
请问让大家感觉是糟糕code的问题在哪，撇开functionX的命名
作者:
acgotaku (otaku)
2015-07-20 22:12:00白目 快笑死
作者:
kenjy (ken)
2015-07-20 22:12:00还看过 fun_x(a,b,c) { ...; fun_x(a,b,c); ...;}
作者: badyy (nick) 2015-07-20 22:21:00
强者不都砍掉重练比较快,干嘛要看
我猜functionY里是要 { ...; return functionX(...);}也许是额外的需求, 但改动量太低, 这样改最快.像是Windows API 中一大堆 CreateXYZ, CreateXYZ 这样?最难的是读懂,接着干.次一级是整段打掉重写,Debug到顺.
再差一级是看不懂,乱骂一通,推给别人,别人还是得接着干
作者: Iemarah 2015-07-20 22:40:00
如果单纯只是c 还真得不太需要注解不过这是对写得人而言 没接触过的人就不一定
作者:
kikichou (下个月爆忙)
2015-07-20 22:45:00至少还有function.....,有一种是没funciton然后变量x1x2
一直都会有人拿一份旧code给我, 叫我加个什么功能.没有一个是好读懂的,能不做吗?先build通再想办法debug看懂原作者的想法,再加新的需求上去不影响原来功能.大家不都是这样的吗.看不满意顺手帮你经过的地方加注解不就好了吗, 这样以后的人至少经过这边就看的懂了.
当然会有,你功力进步,同事也看在眼里,别只是想着功利
作者: c41231717 2015-07-21 00:14:00
对后人是种麻烦 快逃啊 这公司 以后这种事一定越来越多花时间看懂又没绩效 搞不好你写得还更好
作者: badyy (nick) 2015-07-21 08:15:00
真的看不懂时又没文件,会去看unittest,不过有人连unittest都没有 XD
作者:
Csongs (西歌)
2016-07-21 20:23:00奇观
作者: marsyang1 (Mars) 2016-07-21 20:38:00
主管的天花板就是单位技术的天花板
作者:
angusyu (〒△〒)
2016-07-21 20:59:00科技业也有贱民区的好吗? 一堆赛写到发臭再叫外包解
作者:
minikai (一肚子拐)
2016-07-21 21:20:00该公司主管该不会就是本版某篇号称万行code不用一个月就可以滚瓜烂熟，有十几年经验的强者大大吧。
作者:
neo5277 (I am an agent of chaos)
2016-07-21 21:23:00我有看过function call function得啊
作者:
angusyu (〒△〒)
2016-07-21 21:36:00看不懂还没文件,结果会有unit test是什么概念
作者:
ns1234 (FAR)
2016-07-21 21:59:00我同意Code可以不用注解, 但是前提是你的code让人一看就就知道在干嘛 如果无法看code就知道在干嘛就还是乖乖写吧fun名称命名就有问题了 当然会看不懂啊
作者:
easyman (oops)
2016-07-21 22:42:00有可能是偷别人的 binary 然后generate 出来的
作者:
xo1100 (虾蒸河粉)
2016-07-21 22:57:00动脑开发已经够累了还要另外花脑力理解code
作者:
bitcch (必可取)
2016-07-22 01:24:00google里的人是不是强者？google的code写不写注释？
作者:
ADYex (寵物狼音樹)
2016-07-22 03:21:00快逃
作者:
typepeter (∵Peter∴笑点)
2016-07-22 09:01:00通常这种强都是硬干的 程式永远写不大所以台湾一堆嘴王 因为连基本软工什么都没概念多上github，发现原来所谓公司强者不过是呵呵
其实coding跟维护久了，我有些都忘了原本为什么要这么写，其实注解还是写一下比较好，不写注解大概就是没时间，太赶写完交上去没问题就去做别的东西
作者:
Ekmund (是一只小叔)
2016-07-22 10:57:00不错了 有看过变量名称a1 a2的吗？
这种东西看了一次就会致癌 快去大医院做检查！很多crypto sample pseudo code 就是a1/a2/p/h 有事吗？！
作者:
Ekmund (是一只小叔)
2016-07-22 14:12:00当然是讲实际上线团队maintain的东西 sample用得着讲吗？
作者:
femlro (母猪教谋神异端审问官1.5)
2016-07-23 10:30:00强者都直接重写 当然不用注解阿
现入写不写注解的循环就输了，记得重要的是设计文件陷入