※ [本文轉錄自 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強者都直接重寫 當然不用註解阿
現入寫不寫註解的迴圈就輸了，記得重要的是設計文件陷入