看板 Soft_Job 關於我們 聯絡資訊
※ [本文轉錄自 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沒註解也沒有文件 主管說:「強者不需要註解」 -- ※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 49.214.19.219 ※ 文章網址: https://www.ptt.cc/bbs/Tech_Job/M.1468978484.A.B6F.html
loveices: 你去其他公司也會遇到一樣的情況 稍微不順利就想走 不是07/20 09:39
loveices: 一個好的工作態度07/20 09:39
COCOCCC: 就想辦法看懂,然後思考一下如果自己做是不是可以不要07/20 09:51
bpq: 樓上肯定不是寫軟體的,如果工作是在寫軟體而公司又如此不重視07/20 09:51
bpq: 這塊,建議快換07/20 09:51
COCOCCC: 這樣寫,他主管那個回答就是個射後不理的態度,能不能跟07/20 09:51
COCOCCC: 就從一些小事的累積上看出來......07/20 09:52
fallennrise: 讀懂跟花很多時間讀懂差很多好嗎07/20 09:54
agreerga: 這種code還是快走吧....接下去根本自找麻煩07/20 09:57
rolleiman: 其實業界的code,很多是這樣的,同事如果願意教你,比07/20 10:01
rolleiman: 自己摸快很多。07/20 10:01
KernelChen: 強者也是會寫出垃圾的07/20 10:05
dakkk: XDDDDDD 直接離職吧07/20 10:12
kong028: 註解很重要啊!07/20 10:14
gn01216674: 應該是之前離職的惡整老闆吧…幾萬行沒註解,function07/20 10:15
gn01216674: 功能是用硬背的喔?07/20 10:15
f124: 我是都寫架構註解在筆記本上 離職就帶走了...-3-07/20 10:22
eric111043: code 不是一個人就可以搞定07/20 10:22
rockalife: 強者不需要柱柱姊 需要小英07/20 10:26
meowyih: ^^^^^^^^^^^^^^^^^^^^^^^^^ 只有幾萬行的可以07/20 10:27
imafox: 不註解,原作者才有存在的價值07/20 10:36
Colossus: XDDD~~~ 07/20 10:36
loloman: 薪水要是足以找到真強者,不如全部重新寫過算了07/20 10:43
loloman: 與其看一個不一定會動要debug半天重新解讀07/20 10:43
loloman: 還不如自己再寫一個自己編排完整好維護的版本07/20 10:44
magamanzero: 註解的要求可以看出公司的管理態度...07/20 10:45
mickl8101: 如果他給的薪水 是給強者的薪水 那就埋頭幹下去啊!07/20 10:45
loloman: 其實最大的陷阱還不是不會動,而是動錯了你沒發現07/20 10:45
VdustR: 可讀性夠高可以不寫吧07/20 10:46
kevin28: 看錢的多寡07/20 10:50
iamshiao: 不是大俠吃香蕉07/20 11:00
badyy: 癡,不能維護的source才能當一方source閥,不怕失業!07/20 11:04
sweet222: 都嘛可以看懂,但是效率不高,最好有文件07/20 11:06
tallhand: 因為老闆也看不懂,註解錯了被發現就丟臉了07/20 11:11
laurenceliu: 比亂註解好多惹07/20 11:17
Hikkiaholic: 屁啦 最好是主管講話那麼嘴砲07/20 11:24
motoman: 就嘴回去 說 可是我領的是弱者的薪水07/20 11:32
v7q4: 這種淺度思考的爛code 當然不需要註解....07/20 11:40
thg156yu789: 主管講話也會中二?07/20 11:43
wake7078: 強者不用註解 主管沒說錯07/20 11:44
wake7078: 快離職 強者是不會有疑惑的 這間公司太強大了07/20 11:46
NewPassat: 軟工這摸差還叫強者?笑惹...07/20 11:48
ijg: 你可以回說“可是你們不是強者”XD07/20 11:49
b18902040: 直接給主管看。他看不懂就嗆他廢物 07/20 11:52
mlda888: 愛不需要裝乖07/20 11:56
voodist: 騎驢找馬 架構就慢慢摸 要急也是主管急07/20 12:00
Argos: 強者是不需要註解阿 但那是架構和命名好的連註解都是多餘的07/20 12:11
Argos: 但主管的意思大概是說 強者才能看懂沒註解的爛code07/20 12:12
gn00273680: 寫的好的確不需要註解07/20 12:13
DrTech: 這樣就勸人離職,會很容易換工作吧07/20 12:16
v2266514: 強者的確不用註解,前提是程式命名和架構要寫的好。而不07/20 12:17
v2266514: 是要花一大堆時間看懂別人在寫什麼07/20 12:17
Vitaceae: Linus 會註解,真弱07/20 12:23
HAKUKE: 所以主管的意思應該是"強者不需要(看)註解"?07/20 12:24
好像是如此!
elikey: 照老闆的說法,以後報告就都直接丟data就好不需要整理跟結07/20 12:33
elikey: 論,反正強者不需要註解嘛07/20 12:33
這樣的話大概會被嫌「表達能力差」 因為人家是老闆嘛(笑)
dennis2030: 寫的好的確不用註解,但這 case 的確不算好...07/20 12:35
layan: 推樓上 主管的意思應該是樓上所說的07/20 12:39
layan: 不過快逃阿07/20 12:39
※ 編輯: randomly (49.214.19.219), 07/20/2016 12:45:07
kenwufederer: 強者不需要柱姐的概念?根本廢話 07/20 12:46
kenwufederer: 看到快笑死 07/20 12:46
iLinux: linux kernel上的註解實在有夠多,還不太能使用typedef, 07/20 12:56
iLinux: 誰是強者,自己分辨。 07/20 12:56
temt80459: 就是專門搞死新人藉機說程度不好之類的,老鳥保住飯碗 07/20 12:59
temt80459: 的一種手段啦 07/20 12:59
yyc1217: 誰說強者不需要註解XD 寫註解也是給自己看的 07/20 13:10
kissa0924307: 出社會久了就知道 選擇比努力重要多了 跟錯人等於 07/20 13:11
kissa0924307: 浪費生命 07/20 13:11
cat0429: 以前我英文很爛的時候,也都不寫註解的,因為不知道怎麼 07/20 13:21
cat0429: 寫 07/20 13:21
ijg: 推樓上看不對就快跑,下一個會更好,一堆人只會傻傻被凹 07/20 13:21
ijg: 還以為老闆會感激你,大概也只有吃x有你的份而已 07/20 13:22
ssmmss: 跟老闆說你是弱者,請老闆註解 07/20 13:26
mrsix: 這種寫法簡直違反潮流呀XDDD 07/20 13:36
mrsix: 現在寫程式的潮流是命名盡量讓人一眼就看明白,這樣就不用 07/20 13:38
mrsix: 寫那麼多註解了。 07/20 13:38
mrsix: 還好不是Perl,如果是Perl的話真的就麻煩了! 07/20 13:40
boss0405: 強者確實不需要太多無謂的註解,但看這code的命名... 07/20 13:58
felizzZ: 業界的code很多都這樣?? 至少敝公司命名規則好 又有註解 07/20 14:18
vtr198172: 大家的推文怎麼那麼好笑~ 07/20 14:19
Smile365Day: 假的 07/20 14:21
moon2519: 學程式不會寫注解,也是醉了。 07/20 14:23
winken2004: <=弱者 07/20 14:29
banjmin: 人肉obfuscater 07/20 14:33
james732: 快逃+1 07/20 14:34
james732: 強者寫的code指的是不需要多餘註解就能看懂的吧XD 07/20 14:34
xupmc: 寫程式註解是重點阿 塊陶吧 07/20 14:35
supertalker: 真的只寫functionX,鬼知道這是在幹嘛,連傳的值是什 07/20 15:23
supertalker: 麼也沒有很清楚,怎麼debug 07/20 15:23
whipzj: 去github找程式大部分都是有註解 難道他們不是強者? 07/20 15:39
buper: 糖,香料,以及美好的事物...再不小心加入functionX,不會 07/20 16:09
buper: 註解的飛天頗圭能就誕生啦 07/20 16:09
XD978: 沒用goto就算不錯了XD 07/20 16:10
JeremyLin17: 註解代表對程式的態度,不寫註解只代表懶人,不代表 07/20 16:17
JeremyLin17: 強者,後續做處理也會很沒效率 07/20 16:17
unwoman: 推強者不需要柱姐 07/20 16:52
juvyin9507: 太強了都不寫註解,是要怎麼讓後面的新人接上 07/20 17:27
hakkacandy: 前提是 code style 做好 兩者都沒做好的是智障 07/20 18:25
aaaming: 神之code 87變數 07/20 18:48
giantwinter: wtf 07/20 19:00
now99: 別人需要啊 07/20 19:19
Qcloud: 可惜主管是弱者 07/20 19:26
vi000246: 把註解拿來當變數名或函式名就不用註解了 07/20 19:32
dakkk: 這就像宣告變數用a b c一樣 07/20 19:33
johnny4753: 強者不寫註解原因是可讀性高,很明顯這位根本是嘴砲強 07/20 20:09
johnny4753: 補充:是 code 本身可讀性就很高 07/20 20:11
nova06091: 黨,不需要柱姐 07/20 20:12
catvsdog: 塊陶吧 就算是自己寫的扣,沒寫註解久了都有可能忘記在 07/20 20:44
catvsdog: 寫什麼,何況是看別人的,這主管根本沒概念 07/20 20:44
Simonfenix: 天書就是這樣來的 07/20 20:47
overhead: 請問那段code是真的寫"functionX"這樣的function name 07/20 21:15
overhead: 嗎? 07/20 21:16
ts04953635: 請問讓大家感覺是糟糕code的問題在哪,撇開functionX 07/20 21:56
ts04953635: 的命名 07/20 21:56
acgotaku: 白目 快笑死 07/20 22:12
kenjy: 還看過 fun_x(a,b,c) { ...; fun_x(a,b,c); ...;} 07/20 22:12
badyy: 強者不都砍掉重練比較快,幹嘛要看 07/20 22:21
jasonwu23: 我猜functionY裡是要 { ...; return functionX(...);} 07/20 22:32
jasonwu23: 也許是額外的需求, 但改動量太低, 這樣改最快. 07/20 22:33
jasonwu23: 像是Windows API 中一大堆 CreateXYZ, CreateXYZ 這樣? 07/20 22:34
jasonwu23: 最難的是讀懂,接著幹.次一級是整段打掉重寫,Debug到順. 07/20 22:36
s0914714: 強者的確不太需要註解阿 前提是先寫得像自然語言吧 07/20 22:37
jasonwu23: 再差一級是看不懂,亂罵一通,推給別人,別人還是得接著幹 07/20 22:37
Iemarah: 如果單純只是c 還真得不太需要註解 07/20 22:40
Iemarah: 不過這是對寫得人而言 沒接觸過的人就不一定 07/20 22:42
kikichou: 至少還有function.....,有一種是沒funciton然後變數x1x2 07/20 22:45
jasonwu23: 一直都會有人拿一份舊code給我, 叫我加個什麼功能. 07/20 22:51
jasonwu23: 沒有一個是好讀懂的,能不做嗎?先build通再想辦法debug 07/20 22:52
jasonwu23: 看懂原作者的想法,再加新的需求上去不影響原來功能. 07/20 22:52
jasonwu23: 大家不都是這樣的嗎.看不滿意順手幫你經過的地方加註解 07/20 22:53
jasonwu23: 不就好了嗎, 這樣以後的人至少經過這邊就看的懂了. 07/20 22:54
Vitaceae: 然後勞心勞力幫人擦屁股還沒有績效 07/20 23:08
jasonwu23: 當然會有,你功力進步,同事也看在眼裡,別只是想著功利 07/20 23:22
c41231717: 對後人是種麻煩 快逃啊 這公司 以後這種事一定越來越 07/21 00:14
c41231717: 多 07/21 00:14
c41231717: 花時間看懂又沒績效 搞不好你寫得還更好 07/21 00:17
badyy: 真的看不懂時又沒文件,會去看unittest,不過有人連unittest 07/21 08:15
badyy: 都沒有 XD 07/21 08:15
※ 發信站: 批踢踢實業坊(ptt.cc) ※ 轉錄者: ggg12345 (114.43.239.55), 07/21/2016 20:11:59
Csongs: 奇觀 07/21 20:23
marsyang1: 主管的天花板就是單位技術的天花板 07/21 20:38
angusyu: 科技業也有賤民區的好嗎? 一堆賽寫到發臭再叫外包解 07/21 20:59
minikai: 該公司主管該不會就是本版某篇號稱萬行code不用一個月就 07/21 21:20
minikai: 可以滾瓜爛熟,有十幾年經驗的強者大大吧。 07/21 21:20
lensuper: 是系統廠吧? 07/21 21:22
neo5277: 我有看過function call function得啊 07/21 21:23
angusyu: 看不懂還沒文件,結果會有unit test是什麼概念 07/21 21:36
ns1234: 我同意Code可以不用註解, 但是前提是你的code讓人一看就 07/21 21:59
ns1234: 就知道在幹嘛 如果無法看code就知道在幹嘛就還是乖乖寫吧 07/21 22:00
ns1234: fun名稱命名就有問題了 當然會看不懂啊 07/21 22:02
easyman: 有可能是偷別人的 binary 然後generate 出來的 07/21 22:42
sarafciel: 強者不寫註解不等於不寫註解的是強者啊 07/21 22:50
xo1100: 動腦開發已經夠累了還要另外花腦力理解code 07/21 22:57
comesuck: 沒辦法team work的永遠就那樣 07/22 00:26
comesuck: 獨角獸例外 07/22 00:26
bitcch: google裡的人是不是強者?google的code寫不寫注釋? 07/22 01:24
ADYex: 快逃 07/22 03:21
typepeter: 通常這種強都是硬幹的 程式永遠寫不大 07/22 09:01
typepeter: 所以台灣一堆嘴王 因為連基本軟工什麼都沒概念 07/22 09:01
typepeter: 多上github,發現原來所謂公司強者不過是呵呵 07/22 09:03
doranako: 其實coding跟維護久了,我有些都忘了原本為什麼要這麼寫 07/22 09:45
doranako: ,其實註解還是寫一下比較好,不寫註解大概就是沒時間, 07/22 09:45
doranako: 太趕寫完交上去沒問題就去做別的東西 07/22 09:45
Ekmund: 不錯了 有看過變數名稱a1 a2的嗎? 07/22 10:57
tipsofwarren: 這種東西看了一次就會致癌 快去大醫院做檢查! 07/22 11:48
tipsofwarren: 很多crypto sample pseudo code 就是a1/a2/p/h 有 07/22 11:50
tipsofwarren: 事嗎?! 07/22 11:50
Ekmund: 當然是講實際上線團隊maintain的東西 sample用得著講嗎? 07/22 14:12
femlro: 強者都直接重寫 當然不用註解阿 07/23 10:30
Letter1530: 好一點的建議直接走人,壞一點的建議酸一頓再走入 07/25 10:29
comesuck: 現入寫不寫註解的迴圈就輸了,記得重要的是設計文件 07/26 10:10
comesuck: 陷入 07/26 10:11