[閒聊] 寫code不加註解真的很顧人怨嗎

llabc100012/25 18:21不加註解的一定是超級有能的傢伙

killme32312/25 18:21這就一樣兩派人士在吵啊

llabc100012/25 18:21我自己寫的東西不加註解半年後我就不知道它在幹嘛了

sunlockfire12/25 18:21超嚴重，因為幾個月後會連寫的人可能都看不懂

tk13os12/25 18:21前提是code寫的讓人看不懂，還不加註解

linzero12/25 18:21接手的很麻煩，要多花時間理解

killme32312/25 18:21遇過同事是說你要寫註解才能看懂表示寫得爛的

aet6893312/25 18:21還有只把註解當分隔線用的XD

webermist12/25 18:22大概跟大便不沖水一樣的等級

LawLawDer12/25 18:22歷史本文

henry123456212/25 18:22看複用性

awenracious12/25 18:22寫的爛又不註解的真的該死

tk13os12/25 18:22就算是自己寫的也可能幾個月後看不懂

killme32312/25 18:22我自己是沒意見 看主管(

HJC666612/25 18:22不一定 要看是不是寫垃圾

henry123456212/25 18:22註解就是為了這段以後需要改時要用的

gagacrow12/25 18:22寫得好就不太需要 太多註解反而更難讀

henry123456212/25 18:22如果你很清楚這東西就是這次用完就丟的 就沒差

pot123412/25 18:22比註解寫的像日記隨筆的好一點

gagacrow12/25 18:23更慘的是註解沒有維護的 地獄模式

linzero12/25 18:23函式參數名稱取的有其意義也算是種註解

sniperex16812/25 18:23連自己都不一定看的懂了

ayianayian12/25 18:23除非你的變數名稱取得一目了然

yuizero12/25 18:23我直接給你一個題目 a + b = 5

yuizero12/25 18:23然後告訴你 a 和b都是一個正整數 而且在設計者心中是一

yuizero12/25 18:23個唯一解。就這樣

grtfor12/25 18:23不是，是註解內容與事實不符，成年累月不刪的錯誤訊息誤導

OSDim12/25 18:23這垃圾是誰寫的，喔 是我==

kirimaru7312/25 18:23寫得極好可以不加註解 這是真的

kirimaru7312/25 18:23不過你們這些庸才不要隨便就自認為寫得很好嘛

ayianayian12/25 18:23要不然三個月後你會抱怨三個月前的自己

grtfor12/25 18:23當你分析半天發現註解在搞你，你會更生氣

sunshinecan12/25 18:24看可讀性 像變數都命名無意義a,b,c的不加註解就很糟

AMTS12/25 18:24寫得好其實不需要太多註解

AMTS12/25 18:24把說明文件寫好還比較重要

yuizero12/25 18:24好。請問。當你急用。必須知道a b是什麼時。你會不會很

zore1456312/25 18:24會不寫註解，八成是是能力很強的g8人= =

yuizero12/25 18:24幹設計者不註解a b是多少？

nahsnib12/25 18:24顧不顧人怨先不論，一個月後你就會恨自己了

kirimaru7312/25 18:24也有這種大家都苦笑的案例

kirimaru7312/25 18:24https://i.meee.com.tw/T24DsDn.png

moebear12/25 18:25註解不改版的才是==

zelda12312/25 18:25都要2025了誰還寫註解

killme32312/25 18:25what the fuck? 笑死

arrenwu12/25 18:25現在PR如果是我當reviewer 除非是連白癡都一眼能看出來

ilovenatsuho12/25 18:25我覺得比較需要註解的註解

arrenwu12/25 18:25的code，不然我一定要求寫一堆註解 有些我甚至會希望

arrenwu12/25 18:25寫得像作文一樣

hoe110112/25 18:26不會

kirimaru7312/25 18:26認真說的話，在團隊合作時，寫的code讓別人能看懂是

kirimaru7312/25 18:26你的責任，但你不一定要用註解的方式

killme32312/25 18:26你看推文不就分兩派了XD

arrenwu12/25 18:26現在有了LLM之後 程式碼的註解用途比以前更多了

BSpowerx12/25 18:26會分不清abc幹嘛已經不是註解問題了，而是他媽不要用abc

su4vu612/25 18:26自己都會忘記的東西 要給別人猜 試著理解你當時在想啥

tooperfect12/25 18:26跟投影片只貼圖一樣靠北

su4vu612/25 18:26就很麻煩 所以才要註解

orze0412/25 18:26寫的好的話還不算太嚴重

shadow032612/25 18:26真的有註解焦慮就請copilot幫忙寫就好

TSMCfabXX12/25 18:27看老闆在不在意

Porops12/25 18:27確實是寫得好就不用註解，但如果是長期營運的專案，很難

Porops12/25 18:27全部都是好code

arrenwu12/25 18:27很多時候註解不是只是寫 還要人看得懂

lucky041712/25 18:27現在看你可能覺得自己寫得很好 但十年後你再看可能至少

lucky041712/25 18:27要花半天來重讀 回想還不夠惹人厭哦

arrenwu12/25 18:28確實是寫得好就不用註解 <--- 這句話本身就不可證偽幹話

su4vu612/25 18:28註解寫得不好 確實會讓你解讀錯 也是個問題

ccococo12/25 18:28看情況，就算你真的不想寫也要把變數名稱設定好

orze0412/25 18:28最爛的是code改了，註解還沒改，草你媽

BF109Pilot12/25 18:28我有在註解裡連載過偵探小說

shadow032612/25 18:28print("hello") # 印出 hello

arrenwu12/25 18:29PR送出來的時候 幾乎是唯一你有機會要求撰寫者解釋code

orze0412/25 18:29爛code+錯的註解比單純沒註解更垃圾

lucky041712/25 18:29改了程式註解沒改更痛苦是真的 一個誤導可能一天就過去

ghgn12/25 18:29不加註解讓其他人看不懂 這樣公司也不敢炒你

lucky041712/25 18:29了

arrenwu12/25 18:29在幹嘛的時候，那時候就要盡量要求寫得又多又詳盡

arrenwu12/25 18:29甚至我幫忙寫註解都無妨

zelda12312/25 18:29clean code 第四章就是在叫你各位別寫註解了

wifi12/25 18:30大概跟聯絡簿不簽名一樣

arrenwu12/25 18:30"這之後會寫個詳盡的document"=謊言

jeremy798612/25 18:30你如果變數名稱取什麼a b c i j x 三小的 最好就給我

jeremy798612/25 18:30寫註解

MelShina12/25 18:30你之後自己也會看不懂

jerryjerry912/25 18:30不下註解我隔週就忘記我寫了啥 哭

morichi12/25 18:31commit log有寫好就好

RageDoors12/25 18:31不只是寫code的會需要註解啊，有些管線配得超複雜的又

RageDoors12/25 18:31不加個標註，真的下個月就忘記是幹嘛的了

cutearia12/25 18:31除非有什麼特別的問題要提醒 不然正常都不寫的吧

jeremy798612/25 18:31尤其是一堆magic number 又不寫註解為什麼這邊要

jeremy798612/25 18:31帶入100 那邊要帶入3000 最後就是一直在通靈程式碼

s250020512/25 18:31不寫註解一陣子後，連作者都不知道那段程式是在幹嘛的

ilovenatsuho12/25 18:31要有改版紀錄，就算別人不看code，也要知道改了啥

arrenwu12/25 18:31AMTS: 把說明文件寫好還比較重要 <--- 註解都寫不好的，

hoe110112/25 18:31要加寫註解，那簽薪水合約也要該加錢

arrenwu12/25 18:31真的不要期待對方會寫什麼說明文件

kirimaru7312/25 18:31what the fuck那個案例，經典之處在於

kirimaru7312/25 18:31那是一個超級棒的變數搜尋起始值，但又不是數學上最

kirimaru7312/25 18:31佳的 (有一點偏差，但也夠好用了)

kirimaru7312/25 18:31然後寫的人沒說他是怎麼找到這個值的 接手的也問不到

rabbithouse12/25 18:31註解OK，但我覺得code以外的東西像是文件log啥的有寫

rabbithouse12/25 18:31清楚我覺得比較重要

trtrtradam12/25 18:32至少節省人家看懂你在寫三小的時間啊

sunshinecan12/25 18:32命名真的難 寫詳細就很冗長 簡寫又最好另外加註解

akway12/25 18:32商業機密

hoe110112/25 18:32如果是給自己看懂的註解那其實就不是註解，是自我提醒而

hoe110112/25 18:32已

arrenwu12/25 18:32寫說明文件這種事情，只有 騙子 和 菁英 在講

langeo12/25 18:32不寫也會害到自己吧 寫了幾千行後自己也會忘記

tang071012/25 18:32最好的code是能直接看懂 但一般人就給我乖乖寫註解

aegius1r12/25 18:33陳年code最快樂的是註解一堆都跟code合不起來

arrenwu12/25 18:33PR Approver還有立場要求對方寫更多註解；程式碼送進去

Ceferino12/25 18:33現在應該沒什麼差了，直接丟AI

arrenwu12/25 18:34Repo之後 她不爽寫文件或註解你絕對沒輒

sarafciel12/25 18:34可是快速反方根算法是真的就只能那樣寫啊 而且那東西就

sarafciel12/25 18:34算寫了註解也未必一般水準的工程師就看得懂XD

idow12/25 18:34他這邊不是講寫死代碼嗎 想講hard code那種的吧

crazyanight12/25 18:34覺得可以完全不加的真的有在寫嗎 久了你連自己寫的

crazyanight12/25 18:34都看不懂

Giornno12/25 18:34公司祖傳屎山代碼不加註解，敬請見證

lucky041712/25 18:34能直接看懂的code本身就不是什麼大東西，上萬行的你看

lucky041712/25 18:34懂要多久

Jameshunter12/25 18:34變數寫的很直白就沒差 最哭的是全用a1 a2這種的

arrenwu12/25 18:34有AI工具之後註解差得更多

CowBaoGan12/25 18:34不寫信不信一個月後回來看連你自己都看不懂

crazyanight12/25 18:34至少一些關鍵/難懂的部分要寫

linzero12/25 18:35what the fuck那個是較低運算量下求得足夠有效的近似值吧

letmesee308512/25 18:35現在可以叫chat gpt幫你加

oselisdu12/25 18:35什麼一個月 六日放假回來就不認得了

Jameshunter12/25 18:35當然模組是一定要寫這是在幹啥就是了

jay90503512/25 18:36#我前面的都沒寫 我當然也不寫囉

arrenwu12/25 18:36現在有不少AI工具是可以讀了你的repo之後扮演像小幫手的

arrenwu12/25 18:37身分回答你很多廣泛問題。這種有沒有註解就會差超級多

elia032512/25 18:37到時連自己都看不懂就好笑了

antinua12/25 18:37足以放進柯南世界的殺人動機

arrenwu12/25 18:37沒有註解的code，AI就只能給些罐頭回答

arrenwu12/25 18:37你一個 enum class 註解只寫一行或不寫當然無妨啦

RandyOrlando12/25 18:37不寫的話自己都會忘記個八成

shadow032612/25 18:38我看過註解英文文法爛到看不懂的 也看過非ASCII註解然

shadow032612/25 18:38後亂碼的 歡樂無限

fireleo12/25 18:38現在AI可以幫你生註解

Dnight12/25 18:38有時候有問題的不是邏輯看不懂，是為什麼要有這段邏輯

S0487048712/25 18:38我在弄公司老舊程式的CODE 一堆糞CODE不註解

hakosaki12/25 18:38有兩派 一派是命名的好的不用寫 另一派是最好給我寫爛

hakosaki12/25 18:38，我覺得加減都要寫，有些寫死在程式裡面的 還有歷史故

hakosaki12/25 18:38事 最好都留著，免得到時候要考古

Pocer12/25 18:39自己寫的不加註解你離開半年再碰都不知道自己在幹啥

S0487048712/25 18:39寫得好就不用註解的標準是啥?一堆自以為寫得好的

kirimaru7312/25 18:39現實公司就沒有真的在提倡把code寫好寫到不用註解的

kirimaru7312/25 18:39你要用這個藉口不寫註解，到時候在公司天花板飛來飛

kirimaru7312/25 18:39去就不要該該叫

andy7932312/25 18:39設無意義變數讓後面的猜

Peurintesa12/25 18:39這個看能力分階段耶 寫的好的確不用太多註解也能看懂

linzero12/25 18:40AI現在問題是，你不太懂的，AI也不懂時會瞎掰唬的你以為

linzero12/25 18:40他講的是正確的吧

Jameshunter12/25 18:40你們別再瞎吹AI惹 新進來的搞出一大堆炸彈 被炸死還

RINPE12/25 18:40不會 能力差的才寫

Jameshunter12/25 18:40拿出來報告說窩不知道

lucky041712/25 18:41上面那個邏輯可能跟一些老舊硬體有關 這種又更痛苦了

lucky041712/25 18:41你不測根本不會知道

LipaCat556612/25 18:41資料庫欄位不寫說明才頭痛 名稱看不出用途只能通靈

Peurintesa12/25 18:41不太可能完全不寫 就大概寫一下這段程式在幹嘛就好

PatlaborGao212/25 18:41自己寫的作文 會自己加上注釋嗎？

Peurintesa12/25 18:41總不可能每寫一行就要寫註解吧==

data9955312/25 18:42你有自信一年後還看得懂的別人基本上也有機會看懂

data9955312/25 18:42，這樣不寫當然沒關係

kirimaru7312/25 18:42code和作文等級不同 code是一種魔法

BC071012/25 18:42不註解變數名又亂取的應該要被抓去關

terry95504812/25 18:42所以寫CODE並不是同一類功能9成一樣套公式的東西嗎??

dreamnook212/25 18:42實際上是看情況 很多code是顧名思義的在寫

linzero12/25 18:42有的BUG是兼容性問題，這種可能就沒有啥原因邏輯，因為

arrenwu12/25 18:43code 不是作文 註解才是作文

terry95504812/25 18:43因此還需要加上註解才看得懂?

linzero12/25 18:43配合的程式、裝置就是這樣搞，也只能特定方式因應

GOFEN12/25 18:43傻了嗎？ 註解是給自己看的，給別人的都是鳥註解

S0487048712/25 18:43一堆莫名的邏輯又不敢去刪除他怕是有用的

GOFEN12/25 18:43不然怎麼再賺一筆

zxc233118912/25 18:44現在都丟ai看了

kirimaru7312/25 18:44只在一個層面上做單純一件事的code是這樣

kirimaru7312/25 18:44但現實在跑的code可能是100層疊起來的邏輯運作

abadjoke12/25 18:44自己寫的都不一定看得懂了更何況別人寫的

k554533212/25 18:44真的，很多商業邏輯很複雜，文件也不見得齊全，接手的

k554533212/25 18:44人真的很痛苦

aegius1r12/25 18:44//企劃說要這樣做

Jameshunter12/25 18:44幾百行變數名有寫直白是能不用註解拉 可是超過這數量

TCPai12/25 18:44複雜的真的需要註解阿，主建構者都不一定記得全部的細節了

TCPai12/25 18:44，其他的更不用說

orze0412/25 18:44你傳狀態只用數字，不寫註解就是在浪費之後接手的人的時

orze0412/25 18:44間

uohZemllac12/25 18:45/*我不知道這幹嘛的 但不要改這個變數 */

orze0412/25 18:45有一種直白叫做自己覺得直白

starsheep01312/25 18:45寫死還不註解，超欠幹==

Jameshunter12/25 18:45後幾乎都是分成一堆一堆的模組 這時候還沒註解就GG

kcball12/25 18:45註解是寫給自己看的

kirimaru7312/25 18:45更恐怖的是寫這100層的人都有可能寫出

kirimaru7312/25 18:45「code實際上會產生但寫的人渾然不知的嚴重後果」

qwer33885912/25 18:45有時候加註解的code才是更坑人的 有些人改完功能沒改

qwer33885912/25 18:45註解...

z63506612/25 18:46你到火車站沒時刻表也能上車阿，沒毛病

S0487048712/25 18:46寫爛又不寫註解的人不該寫CODE，只是來拖累其他人

s1210847812/25 18:46寫得再好也怕疊床架屋阿，該駐就要駐

babyIam12/25 18:46程式就是文件，一個人寫文件都用自己發明的詞彙然後都不

babyIam12/25 18:46解釋，你感受看看

inte629l12/25 18:46寫死或是magic number的碰都不敢碰

arrenwu12/25 18:46註解寫爛 那PR的 Reviewer要叫她改啊 不能看不懂還送

Peurintesa12/25 18:46不過圖中的例子的確是最欠幹的 寫死不註解是最可怕的

sepzako12/25 18:47你有沒有要給別人看？ 沒有 那你記得就好 有 那你不想被

sepzako12/25 18:47問到煩還是被靠杯就乖乖加 將心比心一下

spfy12/25 18:47西恰到底是有多少工程師

terry95504812/25 18:47以都給WINDOWS用的來說好了，難道不是詞彙都規定好的

jeff66612/25 18:47先求有註解，再求讓所有人都可以看懂

ohmylove34712/25 18:47會被修改的東西才有寫註解的必要，使用說明那種該寫

ohmylove34712/25 18:47的是文檔

terry95504812/25 18:48辭典之類的東西下去邊寫作文的嗎?

bluejark12/25 18:48後面：前面的不寫註解我接手很難懂

AkikaCat12/25 18:48//以前我跟上帝知道這是啥，現在只剩上帝知道了

bluejark12/25 18:48前面的：老子都失業了你不懂關我屁事

chuegou12/25 18:48當限制來自沒有道理的業務邏輯時 不註解別人根本不知道

leviathen12/25 18:48寫的好其實不用註解也很好讀，大部分情況都是寫太爛太

leviathen12/25 18:48複雜才加一堆註解

kirimaru7312/25 18:48如果你明確知道問題只出在第89層，你可以把寫的人叫

kirimaru7312/25 18:48出來電，但實際的狀況是裡面可能有10個你根本不知道

kirimaru7312/25 18:48位置和觸發方法的問題，而且這整坨東西已經在市場中

kirimaru7312/25 18:48客戶手上天天執行，這時你能相信的只有某島國零食了

terry95504812/25 18:48你自己創詞彙的話windows怎麼有辦法認識?

ziggs830812/25 18:48//這段沒用，但是刪了會error，別刪

paul2627712/25 18:49檔 不能沒有 註解

arrenwu12/25 18:50任何的code 都有可能被修改啊

aegius1r12/25 18:50你看得懂別人作文全部的邏輯嗎w

kirimaru7312/25 18:51你是在windows給你的架構之上做事沒錯，但你自己要做

kirimaru7312/25 18:51的事情可能就有100層邏輯了

qd659012/25 18:51沒註解還可以硬讀 只是很吃力 沒欄位文件的超級靠腰...

dongdong040512/25 18:51前提是Code本身寫得有可讀性

dongdong040512/25 18:51但偏偏一堆ninja code卻又不註解的

b482458312/25 18:51只要這隻程式你過好幾個月回來還是看得懂，或是別人看

b482458312/25 18:51得懂，以這個概念來說，你要不要寫註解就沒那麼重要，

b482458312/25 18:51重要的是未來看得懂

qd659012/25 18:51另外可以讓你臭幹誰寫的爛CODE 阿 原來是我 抱歉

lovegensokyo12/25 18:52寫code不註解，連未來的自己都會詛咒你

linzero12/25 18:52但未來的事，沒人能打包票

qd659012/25 18:52我個人只會寫 為什麼要做這件事的註解跟誰叫我改的

shinelusnake12/25 18:53我覺得寫註解像是英文作文寫的太差怕人看不懂所以

shinelusnake12/25 18:53還要附中文翻譯一樣，如果你英文寫得清楚根本不用

shinelusnake12/25 18:53中文翻譯

shinelusnake12/25 18:53維護註解等同於維護兩倍的程式碼，最多就寫程式結

shinelusnake12/25 18:53構或思路就好

orze0412/25 18:53會被修改的東西才有寫註解的必要？？？除非你敢確定debug

orze0412/25 18:53時不會碰到

kirimaru7312/25 18:53另外一個問題，如果windows現有的架構有會導致不確定

kirimaru7312/25 18:53性結果的bug，請問你是要用你全部的上班時間打電話去

kirimaru7312/25 18:53微軟靠夭，還是夾緊你的括約肌，把眼淚吞下去，想盡

kirimaru7312/25 18:53辦法頂著這個bug還能把你的工作做好?

s250020512/25 18:53涉及到計算方面的，再怎麼好讀回頭再看也記不得為啥要

s250020512/25 18:53這樣算

ilohoo12/25 18:54加註解可以讓原作者和其他人看得懂

S0487048712/25 18:54我認識的不寫註解又寫得很難懂的，大多他的CODE問題多

The4sakenOne12/25 18:54可讀性夠高可以不加

lucky041712/25 18:54只能說 有多少屎山代碼證明了那些覺得自己寫很好的都…

lucky041712/25 18:54…

tim520131412/25 18:55註解沒更新的才哭 跟code對不上

JUSTMYSUN12/25 18:56///記得刪掉

aegius1r12/25 18:56code夠好不用寫註解 跟很有錢買東西不用看價錢一樣

Shawn568912/25 18:56註解是用來記錄違反常理的事情 有些事情不是自己可以決

terry95504812/25 18:56Kiri大的解釋利好血汗但又真好懂XDD原來是這個意思

Shawn568912/25 18:56定的

qd659012/25 18:56//這邊先這樣 之後再改 去你媽的 之後是什麼時候

qwe7897112/25 18:57看狀況 完全不加 要交接很難 通常命名會很清楚 怕的是

qwe7897112/25 18:57abc void a(x) 這種天才

Peurintesa12/25 18:58實務上真會出現a,b,c這種變數嗎?這不只寫的人要被幹吧

cutearia12/25 18:58那種亂命名來搞的 公司哪會讓你merge進去

orze0412/25 18:58有一種好是自己覺得好

S0487048712/25 18:58我做過6~7間公司 能讓我覺得寫得好不用註解的人沒幾個

oyaji556612/25 18:58我的話 閒的時候會把需求寫進去 忙的時候只註明magic

oyaji556612/25 18:58 number的由來跟用途

cutearia12/25 18:58review時先被主管噴一頓

kirimaru7312/25 18:58超內層為了加速運算而寫出的小函式可以允許

su4vu612/25 18:58就懶阿 反正也沒人會看

howtotell12/25 18:58這個真的要寫

aegius1r12/25 18:58你要先確定公司有review欸(

linzero12/25 18:58不過ijk這種有的是用在很多層的迴圈裡吧

orze0412/25 18:59你以為所有公司review都會看那麼仔細嗎？

NingK12/25 18:594，不寫連你自己都看不懂自己寫的

s250020512/25 19:00很多公司不是能執行就過了嗎，誰會逐步執行一行一行看

kirimaru7312/25 19:00中大型公司review至少會有一定的程度，那個真的有用

chunfo12/25 19:00未來的你會最恨你

kirimaru7312/25 19:01小型的就....你覺得鳥的程式會給熊review嗎 當然沒有

slainshadow12/25 19:01未來的你：我當初寫這段是要幹嘛的？

cutearia12/25 19:01當然不會一行一行看啊 但這種一眼瞄過去就很明顯

kirimaru7312/25 19:01code review本來就是像濾網一樣的東西

kirimaru7312/25 19:01厲害的人他的濾網就是有價值

corum6897212/25 19:02https://youtu.be/wqeGPX7TRv0

Puye12/25 19:02不懶就注一下 別人在看才會比較輕鬆

s250020512/25 19:02當未來要debug的時候確實是那時的你最恨當初的你

kirimaru7312/25 19:02大家都把濾網捅破還裝沒事 那就大家一起死

qd659012/25 19:02我覺得註解最需要的地方就是接別人爛CODE又沒時間重構的時

qd659012/25 19:02候 已經花很大力氣好不容易看懂了 一定要寫下來到底在幹麻

orze0412/25 19:03有的公司連git版控都沒有，這版改了什麼還要自己diff

gate21012/25 19:03本體盡量寫好 註解只在必要的時候寫就好 不然改code連註

gate21012/25 19:03解也要一起改也是很麻煩

andy012112/25 19:03Clean code

engelba12/25 19:04維運到20年前的糞code 就知道有多開心了 有註解至少知道

engelba12/25 19:04需求是什麼

yn9650312/25 19:06別再說寫的好不用加註解了，每個人都嘛自我感覺良好認為

yn9650312/25 19:06自己很會寫很好讀，我帶的案子看到一個註解都沒有誰管你

yn9650312/25 19:06寫什麼一律抓來噴

kirimaru7312/25 19:06大公司對程式的要求不是像什麼書本上的美妙範例

kirimaru7312/25 19:06而是一些類似軍事管理的要求要所有人遵守

kirimaru7312/25 19:06除非你就是想跟所有人對著幹 否則就乖乖遵守就好

kirimaru7312/25 19:06對程式無規則要求的職場不會比較好玩

sakeru12/25 19:06不加註解是要人家通靈喔

ayuhb12/25 19:06跟配線不標示線號一樣嗎

lininu12/25 19:06淦你不寫註解數年後回來修，你看得懂或跟別人解釋當時為什

lininu12/25 19:06麼這樣寫，你就可以不寫註解

oyaji556612/25 19:06// 客戶堅持要這樣做

orze0412/25 19:06學校時，課程作業會把clean code當評分標準嗎？還是答案

orze0412/25 19:06對就好？

s8104811212/25 19:07真的 不加註解真的讓人不爽

arrenwu12/25 19:08學校的程式作業 註解都馬是交給助教看的 出問題重寫

kirimaru7312/25 19:08學校一般不太會管 因為這個給公司電就好

arrenwu12/25 19:08可能比debug快多了 反正上完課之後就是廢code不用維護

louis072412/25 19:08可以啊 你就永遠不要讓別人維護 跟自己永遠看得懂自己

louis072412/25 19:08在幹嘛XD

louis072412/25 19:09我自己上個月寫的程式我可能就看不懂這什麼狗幹邏輯了

peefly12/25 19:09text-align: left; /* 客戶說要偏右 */

peefly12/25 19:10然後你就不知道是客戶又改了還是註解漏改

kirimaru7312/25 19:10真的漂亮到一看就讚嘆的code是有可能存在的

kirimaru7312/25 19:10可是你的無註解code就是被噴了啊 那就是不夠漂亮嘛

Wayne092612/25 19:10不加 幾個月後來看自己也看不懂了

deflife12/25 19:10// just magic

linzero12/25 19:11學校的程式作業不會多大且目的明確，不寫註解其實也還好

AkikaCat12/25 19:11當下的你：這段帥爆了，不用註解也知道在幹嘛

dk248624812/25 19:11會動就好

AkikaCat12/25 19:11下個月的你：誰把上個月的我抓來讓我扁一頓

arrenwu12/25 19:11所以才需要reviewer啊

kingroy12/25 19:12變數名，函數名，class名都取的很標準的，可以不寫或寫很

kingroy12/25 19:12少，但一定規模以上不寫幾乎不可能

kirimaru7312/25 19:12可能會有這樣的狀況

kirimaru7312/25 19:12text-align: left; // 不加的話頁面垂直對齊會失效

kirimaru7312/25 19:12哪個人敢刪掉這條註解就給我刪看看

zizc0671912/25 19:12不加註解，過一段時間連你自己都看不懂好嗎

snac12/25 19:12基本上好的程式看naming要能看出大部分，複雜的才要特別寫註

snac12/25 19:12解

h010366112/25 19:12註解還好，程式夠乾淨、名子別蝦雞巴取都還看的出來，一

h010366112/25 19:12個泛型當戰神用才討人厭= =

kirimaru7312/25 19:13code review真的不是騙小孩的笑話，它真的有用

orze0412/25 19:13學校作業一堆連排版都壞七八糟

s97142512/25 19:13不加註解只有神或廢物，廢物占99%

kingroy12/25 19:13有寫接手交接所需的時間比較少，但一般取名取很差的，註

kingroy12/25 19:13解也寫的很差

linzero12/25 19:13不過寫嵌入式系統資源有限之類的，有時變數不能用太多，

arrenwu12/25 19:14以前code review我還覺得"幹 怎麼一直要我寫一堆註解"

RuinAngel12/25 19:14曾經覺得隨手寫個小程式輔助用的就不用加註解了

kirimaru7312/25 19:14新人剛進公司的code被評價為矮噁是很正常的

kirimaru7312/25 19:14不用灰心，遵守規則就好

arrenwu12/25 19:14現在回想只覺得"挖糙 我以前註解寫那麼少喔"

Kururu807912/25 19:14不怕沒有註解，就怕亂註解誤導後續接管的人，整組壞光

Kururu807912/25 19:14光

linzero12/25 19:14可能會一個變數多種用途吧

RuinAngel12/25 19:14過了半年想要加點功能跟改 bug 的時候只想砍死我自己

uoyevoltnaw12/25 19:14code很好不用寫的通常就是……

kingroy12/25 19:15行業標準的註解就去看自動生成文件那些怎寫就知道了

miyazakisun212/25 19:16肉便器代碼 用過一次就不理的話可以

newasus12/25 19:16// 敝公司碼農領的薪水用行數計算

felix103112/25 19:16寫得爛還不承認的最爛

iwtwin08605112/25 19:17漂亮的程式碼不等於容易看懂的程式碼

iwtwin08605112/25 19:17反而容易讀懂的程式碼 常常是過於冗長

iwtwin08605112/25 19:17打個比方就是

iwtwin08605112/25 19:17好的程式碼就是一個漂亮的公式

iwtwin08605112/25 19:17簡潔又高效

iwtwin08605112/25 19:17沒看過證明 你是要怎麼了解公式怎麼來的？

iwtwin08605112/25 19:17你不了解 怎麼客製優化和調整參數

devil11578912/25 19:17除非一看就知道在幹嘛，不然還是寫一下吧…半年後自

devil11578912/25 19:17己都看不懂了

pikachu817712/25 19:17不加註解我連自己1個月前寫的code都看不懂..

aa147788812/25 19:17你不寫可以 但你不要給別人review

miyazakisun212/25 19:17不寫註解= 小組組員問你問題你已讀不回

arrenwu12/25 19:18沒啦 已讀不回應該是 github上面人家留comment你直接

arrenwu12/25 19:18啥都不做就按下 resolved

arrenwu12/25 19:18這種很容易起糾紛的

kingroy12/25 19:19一個月後可能換個project就想不起之前在趕嘛

black5100212/25 19:19不註解就是後面自己或者接手的人完全看不懂

Anchorage12/25 19:19不加comment真的有夠夭壽，後人還要通靈通個老半天

usoko12/25 19:19看你寫的code好不好懂 但不管再怎麼會寫code的人

kirimaru7312/25 19:19這跟在萬神殿問到本子名的瞬間就刪文一樣惡劣嗎

usoko12/25 19:19都一定會碰到必須把code寫得很醜 再加一堆註釋的情況

usoko12/25 19:20你不加註釋 那段code過一段時間就會變成廢物跟技術債

arrenwu12/25 19:20跟好不好懂沒有關係啊 你開一個新的class 在我讀程式碼前

arrenwu12/25 19:20就該有一段文章在描述這class是幹嘛的

arrenwu12/25 19:20而不是我要讀了程式碼之後才知道你在幹嘛

baliuzeger12/25 19:21有型別的語言問題小一點

arrenwu12/25 19:21現在有 Copilot，寫作文比以前方便多了

baliuzeger12/25 19:21沒型別的語言該註解沒註解的話超難通靈

kirimaru7312/25 19:21中心思想就是：好好做個人，讓別人能看懂你的code

kirimaru7312/25 19:21你要每行都註解還是把87%註解集中在關鍵處就看你

kirimaru7312/25 19:21反正別人能看懂就沒事，看不懂就一起浪費時間

usoko12/25 19:21那看是什麼語言 有必要的話我就在file name跟class name

usoko12/25 19:21把這個class是做什麼的直接寫完了

arrenwu12/25 19:21這不太可能吧？ 你class name 可以寫500個字喔？

arrenwu12/25 19:22講500個字誇張了 但你總不可能寫50~100字吧

usoko12/25 19:22你一個class做的事情要用500字來寫不就代表class太大了...

kirimaru7312/25 19:22那個比較像document，但順手寫成註解也可以

arrenwu12/25 19:22document這個東西我想都不敢想了

usoko12/25 19:22比較大的class確實很難命名 那種情況的確要寫說明

oyaji556612/25 19:22// 因客戶說他老花眼一直輸錯認證碼因此需要把輸入的

oyaji556612/25 19:22值1=I=L，2=Z，5=S

kirimaru7312/25 19:22看是哪種class啊，如果class是一隻狗

XFarter12/25 19:23clean code 的許多準則很好，但不是絕對準則，許多跟算法

arrenwu12/25 19:23我上面說了 嘴巴上說會寫document的 不是精英就是騙子

XFarter12/25 19:23有關係的函數不寫註解不寫 argument 只憑個名字就期待大

XFarter12/25 19:23家知道結構在幹嘛就真的會讓人惱火==

XFarter12/25 19:23我個人認為越底層、越接近硬體行為的 work 越不能不加注

XFarter12/25 19:23解

freedom011612/25 19:23會加但不會有很多 通常是特殊情況會解釋一下 一般來

freedom011612/25 19:23說你的程式碼本來就該寫得讓人看得懂 不然review 怎

freedom011612/25 19:23麼可能會過

kirimaru7312/25 19:23那你覺的這是一隻狗算不算講完他能作的事情

usoko12/25 19:23但很複雜的多個class我就直接寫module REAME了

usoko12/25 19:23*README

arrenwu12/25 19:23會寫document的，有啥理由PR的時候不加註解？

JamesChen12/25 19:23除非那個 code 沒有其他人要看，而且你自己的記憶力超

JamesChen12/25 19:23好，不然即使自己用的 code 都該為了未來的自己寫註解

ayumi00112/25 19:23當你看過註解和程式之間的走向完全不同的時候你就會有另

adonisXD12/25 19:24自己都看不懂還不加註 不就找自己麻煩

arrenwu12/25 19:24@kirimaru73 不算 你還要告訴我為什麼這裡有吃狗 要幹嘛

ayumi00112/25 19:24一種看法了

usoko12/25 19:24自己寫的code大概半年不碰就會忘光了 一定要寫

arrenwu12/25 19:24PR還在審視的時候，你還能卡著逼對方寫註解

arrenwu12/25 19:24Code 送進去之後 對方不鳥你你根本沒轍

Arashi073112/25 19:24我也沒在寫註解了，乾淨架構下去，然後變數跟方法命名

Arashi073112/25 19:24寫好，基本上看得很清楚

kirimaru7312/25 19:25那些我就會直接寫在class Dog的上面了 應該和你期望

kirimaru7312/25 19:25的一樣

usoko12/25 19:25clean architecture有幫助 但不是萬解

arrenwu12/25 19:25某種意義上 寫註解就跟買保險很像，這個東西就是盡可能

arrenwu12/25 19:25避免未來某一天「幹!!!這到底是三小」的機會

arrenwu12/25 19:25但也可能最終發現註解寫得不好所以沒有用

arrenwu12/25 19:26但絕對比不寫好得多

usoko12/25 19:26我自己的判斷方式 只要nested到一定程度(3層之類) 就一定

orze0412/25 19:26問題不是這段在做什麼，而是為什麼要這麼作

usoko12/25 19:27要寫 不然不熟的人絕對浪費時間看

Arashi073112/25 19:27重點把是你的架構訂好，依循著架構放檔案，各種依賴跟

Arashi073112/25 19:27參考都有照著規則比寫一堆狗屎註解重要

tommy5666512/25 19:27這個本來就是分兩派好嗎..

orze0412/25 19:28大型project最後都難免變違章建築

Alcazer12/25 19:28以前教授說他都寫德文 不想給別人看懂

usoko12/25 19:29這年頭lint都會檢查啊 即便如此還是有可能寫得很複雜

amsmsk12/25 19:30不加註解自己也會看不懂吧

LeoYuri12/25 19:30不加註解，我還真的無法一瞬間看出來在幹嘛

alaf12/25 19:30一個月前的自己:自己寫的一定懂 一個月後的我:這段是啥鬼

kctrl12/25 19:31自己的程式加註解都要思考幾分鐘在幹嘛了，更不用說別人的

kctrl12/25 19:32我相信世界上有天才不需要註解，但那個人絕對不是我

abd8673112/25 19:33比不簽聯絡簿還噁心

s207072s12/25 19:33有一派是code好不用註解，但現實通常是隨時間跟經手的人

s207072s12/25 19:33變多gg

dnkofe12/25 19:35看你的程式別人需不需要用，需要的話還是要註解

alpho12/25 19:36雖然取名能解決很多閱讀問題 但註解可以直接省下這些問題

alpho12/25 19:36，特別是遇到取名new或是obj的人

orze0412/25 19:36還有一種是註解裡故意埋炸彈給接手的垃圾

edwardtp12/25 19:37自己寫都不一定知道在幹嘛，一定要加註

ilohoo12/25 19:38寫code的動機是“客戶說”那就註定好不了。乖乖把“客戶希

ilohoo12/25 19:38望能夠1+1=5”寫在註解上

milkool12/25 19:39不加註解死全家

b32501912/25 19:40不寫註解一樣能埋炸彈特例就別說了

andy323112/25 19:40看過一本講refactor的有提到盡量不要寫註釋，只有特殊

andy323112/25 19:40情況才要寫

s250020512/25 19:40一堆亂七八糟的調整都嘛是來自“客戶要求”，別想會多

s250020512/25 19:40好

sunshinecan12/25 19:41//呃...就命名字面上的用途

six9325012/25 19:41除非整個團隊英文能力都很好，不然clean code的意思是

six9325012/25 19:41變數與函式的命名要清楚到能直接看懂程式的意思

andy323112/25 19:42我同事兩百行code有一百行是註釋不知道在衝三小

lucky041712/25 19:42這個問題其實很簡單 現在回去翻自己幾年前寫的 測測自

lucky041712/25 19:42己不看註解的情況下要用多久能全理解

sunshinecan12/25 19:42當然有些特例 像是寫random但實際上有加權時就要註解

lylu12/25 19:42除了註解本來就有很多地方可以記錄資訊啊 你commit msg也是

lylu12/25 19:42要寫清楚 clean code就是追求程式碼本身就是註解 function

lylu12/25 19:42跟class名稱都要有意義

six9325012/25 19:43但大多數人連命名都亂七八糟的

FCPo01167412/25 19:45我是覺得可以讓命名、結構易懂比寫註解重要，不然程式

tuwulisu611112/25 19:45有時註解反而在騙人 不如專注在把命名做好

FCPo01167412/25 19:45碼改了註解沒改也有機會變炸彈；不過程式複雜或是有什

FCPo01167412/25 19:45麼需要特別說明的地方還是要下註解

odanaga12/25 19:45寫很爛又沒註解 就王八蛋

ARTORIA12/25 19:46看不看得懂是一回事 寫了是幫之後看的人省時間

ARTORIA12/25 19:46就算code寫得好懂 每次重看也是浪費時間

wzmildf12/25 19:46有自信永遠不帶給自己和他人困擾就別加，我連一個月前自

wzmildf12/25 19:46己在excel寫的VBA 都可能看不懂

thelittleone12/25 19:46註解寫了也要記得更新 改code不改註解寫心酸的

bdenken12/25 19:47Chatgpt 都會寫好註解

togs12/25 19:47自己寫的都不一定記得了。

emptylife312/25 19:48我看現在大師的說法是追求程式的可讀性要高，夠高的

emptylife312/25 19:48話不註解也很清楚

ohohohya12/25 19:48我都有git了還註解啥

s5656556612312/25 19:48真的寫到很簡單根本不用註解

highwayshih12/25 19:49除非你是那種Code可讀性極高 誰來都能馬上理解的神人

lylu12/25 19:49不然就build script最後加doxygen 沒寫直接build fail

coronach12/25 19:49有很多地方可以放解說，不需要都寫在註解

highwayshih12/25 19:49不然寫扣不加註解真的罪該萬死

coronach12/25 19:50commit msg跟README還有design doc都可以寫

oread16812/25 19:50然後變數用ABCD1234不命名 爽不爽

e2ne012/25 19:50命名就知道是在幹嘛了 幹嘛還要註解==

Dayton12/25 19:51對 超級

shallreturn12/25 19:51寧願加註解也不要相信自己看得懂自己的東西

shallreturn12/25 19:51你自己寫的日記都有可能不知道你在寫什麼更何況是代

shallreturn12/25 19:51碼

devilkool12/25 19:52有的流程、特殊邏輯，變數跟方法命名都無法表達的

highwayshih12/25 19:52回頭看自己三個月前寫的東西都有可能看不懂了

keichi12/25 19:52其實不會

Beltran12/25 19:522025還有人把clean code當聖經 幾年前就戰過了

highwayshih12/25 19:52有機會被別人看到的Code不加註解想害死誰

ltytw12/25 19:52寫代碼不加註解。就算只有自己會看也是一段時間連自己都看

ltytw12/25 19:52不懂

hanklee6612/25 19:53寫得再好也不可能理解起來比註解還好吧，註解都亂寫的

hanklee6612/25 19:53他程式會好好寫嗎...

FiveSix91112/25 19:53超多的好嗎 超討厭

plamosuki12/25 19:54寫註解就是要告知這坨大便是什麼原因產生的啊

hsshkisskiss12/25 19:54真的很賭爛

AlphaMC12/25 19:55看你是當個人日記還是出版書籍來寫啊，只是個人日記過幾

AlphaMC12/25 19:55個月連自己都不知道在寫什麼了

Peurintesa12/25 19:55對耶 註解寫得好的人那原始碼應該不會爛到哪吧

Bf109G612/25 19:55issue解一解 忙了半年之後回頭過來看 就忘記我在幹嘛了

yys31012/25 19:55三個月後自己看都忘記了

FCPo01167412/25 19:56這麼說好了，寫出易懂的程式是一個理想；但現實是不可

FCPo01167412/25 19:56能完全達到的，不管是有特殊邏輯，或是寫的東西並沒有

FCPo01167412/25 19:56那麼好懂。一定或多或少要有註解輔助

FCPo01167412/25 19:58其實註解寫的好不代表原始碼會多花，我遇過一個leader

FCPo01167412/25 19:58註解寫很勤且很多，也要求底下的人照做；但我接手他的

FCPo01167412/25 19:58code後改到快吐了

FCPo01167412/25 19:59*多好

shinchen12/25 19:59偏底層的程式要搞加速或省資源的時候就管不了可讀性了

Void95612/25 19:59有時候註解說的是一回事，程式碼寫的卻是另一回事，所以

Void95612/25 19:59註解真的比較好嗎？

Dlareme12/25 20:00不用三個月 忙一點同時兩三個案子 下個禮拜就忘了

as663320812/25 20:00其實，真正優秀的團隊，是真的不用註解，含在design pa

as663320812/25 20:00ttern惹..

FCPo01167412/25 20:00各種惡用巢狀迴圈，即使裡面寫了滿滿的註解，我還是很

FCPo01167412/25 20:00難修；最後我就直接打掉重寫了

coronach12/25 20:00遇過資深工程師意見超多+話超多+文件超長，但是一半左

coronach12/25 20:00右是廢話的

as663320812/25 20:01無註解是比較理想化，實際有些東西還是要註解會比較清

as663320812/25 20:01楚

chris51012712/25 20:01你兩個月後回去看自己的程式就差不多忘了

ARTORIA12/25 20:02不可能無註解比較好啊 你有註解你的程式碼我不用全懂

coronach12/25 20:02實際上一定會需要註解，大部分是用在special case or w

coronach12/25 20:02orkaround

ARTORIA12/25 20:02要修改部分功能 有註解改起來也快

Jimmywin12/25 20:02連自己都看不懂

coronach12/25 20:02通常真正的問題是，那些特殊性高的code寫完就忘了維護

coronach12/25 20:02，註解也沒用

shinchen12/25 20:03搞底層韌體有時候會需要計較這段code怎麼寫編出來可以少

shinchen12/25 20:03幾個指令或多少RAM 這種不留註解沒人知道你幹嘛這樣做

Syalon12/25 20:04這串吊出一堆寫扣大佬

Void95612/25 20:05我自己寫程式也是偏向少註解，因為用code說話比較好。

sustto12/25 20:064

shadowblade12/25 20:06我自己是無法理解自己看不懂這件事啦,可能我的思考

shadowblade12/25 20:07迴路是基本很難變動的那種

rizman2812/25 20:08現在有LLM其實也沒差了我覺得

andykimo12312/25 20:09自己寫得看久了當然會看懂，只是你要花多少時間去看

andykimo12312/25 20:10寫註解可以幫助自己回想的快很多

ARTORIA12/25 20:11對阿 懂不懂是一回事 主要是省時

leonEEman12/25 20:11我公司就是喔 主管還自以為code寫很棒

ren74071912/25 20:13說寫Code不用註解的，都是待在同事都是高手，離職率超

pumapupa12/25 20:13有些狀況是寫理由 看得懂code也不一定知道為甚麼這樣寫

tmwolf12/25 20:13超靠北

ren74071912/25 20:13低的公司吧?

ccukiller12/25 20:14大神寫出來的就算加註解一般人也看不懂 邏輯完全跟不上

ren74071912/25 20:15我待過沒Code Review的公司，接手離職人員的專案，我只

ren74071912/25 20:16想寄一箱手榴彈去問候他

tmwolf12/25 20:17本篇講的就是寫死的，寫死又不留註解，後面接力的人大家都

tmwolf12/25 20:17要當通靈王

jack52912/25 20:19如果有workaround 或是 複雜邏輯 沒加就垃圾人

pantani12/25 20:19就像你創出一道菜沒做筆記某天上了菜單 別說要同事復刻

pantani12/25 20:19 連自己都不一定記得調味的份量

driver081112/25 20:20TODO 需要增加註解

joeii012612/25 20:20改code完沒改註解更加糟糕欸嘿

hanklee6612/25 20:21一碼歸一碼，註解沒改是改的人的問題，不是當初寫的那

hanklee6612/25 20:21個

RS23212/25 20:22不加註解然後全部參數都是abc順編

RoastCorn12/25 20:23這是犯罪==

drinkmuffin12/25 20:26命名就是註解了 不要寫一推難維護的註解

yesyesyesyes12/25 20:27如果架構爛又不寫註解的真的很過分，要其他人通靈嗎

k96060812/25 20:29跟古文還有甲骨文一樣 資訊超少 自己掰

mmppeegg12/25 20:30超杜蘭，尤其是人過世了，接他的code每天在解謎

joeii012612/25 20:33被糾正過只要方法、物件、變數名稱有取好，其實不用寫

joeii012612/25 20:33太多註解，要不然有人接手改code還要對照改註解比較麻

joeii012612/25 20:33煩。

siro020712/25 20:33不過有時候註解也不好寫 以前寫了一些數學解題演算法 但

siro020712/25 20:35我註解只有寫變數使用規則 結果我計算出演算法的紙搞丟

willy98623112/25 20:36沒寫註解 一個禮拜後就都不知道在寫什麼了

siro020712/25 20:36了 導致我光看code也看不出我當初是怎麼算出這套公式的

h6041412/25 20:384 大概就只顧自己爽的傢伙 交接他的東西跟通靈一樣

frankfipgd12/25 20:38不加註解…連自己都坑好嗎…

a717366173612/25 20:40不加註解 半年後連我自己都看不懂

vul3kuo12/25 20:41註解不維護比不寫註解還要討厭

iamsuhyeon12/25 20:43丟給chatgpt就好啦

leophior12/25 20:45不寫註解 下個月的自己就看不懂了

yu777712/25 20:46心理變態484

devilhades12/25 20:49泰德創造了三個工作機會 謝謝泰德

laechan12/25 20:49註解其實是寫給自己看的，不寫的人遲早業力引爆，痛過才

laechan12/25 20:49會知道痛

kevin031612/25 20:57不加註解的都是低端pg

vios1000912/25 21:00註解寫得好也是能力之一

Richun12/25 21:01寫太多註解會出現一種更靠北的情況，註解過期了沒修正。

defreestijl12/25 21:01段落跟region會加 方法的類本身直接名字寫清楚就夠了

rainight121812/25 21:01通常在變數跟函數命名時命名的精準，就不太需要註

rainight121812/25 21:01解了，因為可以推敲

jgoodman12/25 21:04還好吧 程式碼本身可讀性比較重要 註解是特殊情況才加

kojojo12/25 21:04不寫註解 沒上班時間 就是call 你解異常

gamesame771112/25 21:06想到就非常不爽

kentyeh12/25 21:06看單元測試就知道設計意圖

bellea7006812/25 21:07當然是第一版加註解 第87版繼續用第一版的註解

XFarter12/25 21:08強制註解一定要下在函數的名字前面或 content 的第一行、

XFarter12/25 21:08解釋當前的行為邏輯就不會有忘記修的問題了吧

XFarter12/25 21:09但這就要靠個人甚至團隊的約束

AmibaGelos12/25 21:13設計決策magic#等code無法涵蓋的資訊才需要註解ㄅ

spfy12/25 21:17註解寫太多沒有跟真實扣一起改我坑過自己 幹 之後開始反省

Ayukawayen12/25 21:21程式是照程式碼跑，不是照註解跑。

Ayukawayen12/25 21:22註解寫錯寫爛了要抓出來，比程式碼寫錯寫爛要抓難多了

mbla12/25 21:37比較常遇到code囤積症，舊的code想刪掉但又不想刪乾淨，覺得

mbla12/25 21:37以後有可能改回去，所以直接把舊的code註解

denny041112/25 21:38ninja code, 變數名：a, b, c, d, e...

felaray12/25 21:39還好我都用中文命名

mike2685a12/25 21:44自己回頭看都有可能看不懂了

ThreeNG12/25 21:50https://i.imgur.com/uqppu1M.png

ZhengMark12/25 21:50亂註解比較搞吧

ikachann12/25 21:52我要底下PG寫簡單功能註解，主要是確定他真的懂...有些

ikachann12/25 21:52會莫名亂抄東西貼上 根本不了解裡面在做什麼

bigbeat12/25 22:00變數至少要說明一下啊

aegius1r12/25 22:00然而這年頭你會遇到PG丟GPT註解..

kingo232712/25 22:04笑死這串怨氣是多重

ejnfu12/25 22:12理論上應該是要能不寫註解就看懂得

Alex54829112/25 22:21某些特定操作一定要寫吧

Alex54829112/25 22:21不寫就算自己寫的過一陣子回來看也不知道在幹嘛

wulouise12/25 22:22revirwer叫你加就加，別人看不懂就是你的問題，除非你下

wulouise12/25 22:22周閃人

smartsnake12/25 22:28看到大家的回應忽然覺得自己記憶力沒那麼差了

kingroy12/25 22:32有版控就別屯了

kingroy12/25 22:33但註解寫錯不會出事，Code寫錯會，註解錯了了不起改一下

kingroy12/25 22:33，也不用重跑測試

Ayukawayen12/25 22:37不太確定你想表達的意思。寫錯會出事是很好的特性..或

Ayukawayen12/25 22:37許不是真的很好，但寫錯不會出事肯定是很爛的特性。

terry650312/25 22:47我通常都寫：別動，我也不知道為什麼可以運作

ayubabbit12/25 22:59丟給AI

GAOTT12/25 23:08要寫 但必須只有自己能幹 不然老闆隨時辭退你

tomhawkreal12/25 23:29如果你看到匪夷所思的註解 必須知道這是日常 XD

elic257712/25 23:29變數參數不好好命名，命名abc的才是在搞

BANDITCS12/25 23:34會，超幹，寫註解反而搞的更難懂就更麻煩了

wanzi060112/25 23:39註解對開發沒屁用，是因為開發的人不用維護....做維護

wanzi060112/25 23:39的人最煩不寫註解的混蛋

chaahk201212/25 23:42不加的就保佑不會雷到自己

chaahk201212/25 23:42除非心機很重 注釋寫另一份

shoederl12/25 23:45我大學升書研究所左右看清自己只是凡人後明白一個道理，

shoederl12/25 23:45就是寫任何報告或程式，一定要遵循「三個月後自己回來看

shoederl12/25 23:45能看懂」的原則，不然寫出來的東西都是只能用一次的廢物

WWIII12/25 23:57最好的扣 是不用註解

ailio12/25 23:58完美的程式或是小流程，不太維護不太修改的沒註解沒差，常

ailio12/25 23:58維護的沒註解最後一人加一段就沒人認得了

ppc12/26 00:041. 好的code本身要能夠自我解釋 2. 註解是用來寫你這段code想

ppc12/26 00:04要達成的事情，而不是這段code實現的細節

PerFumeLove12/26 00:21還好我覺得

upeo12/26 00:39註解還能幹譙人 好註解不寫嗎？

yueayase12/26 00:47做學生倒是懶得加

yueayase12/26 00:47理由：1. 多寫多錯 2.分數不會比較高 3. 連自己都看不懂

nomosa12/26 00:49不加我有可能幾個月後就不知道自己在寫三小

rickey127012/26 01:49屎山代碼愈來愈多的癥結

jackjoke200712/26 02:13歷史本文

annboy12/26 02:28註解某種意義上比程式本身還重要

leviathen12/26 05:50最需要註解的是莫名其妙的feature ，這個不寫一定早晚

leviathen12/26 05:50出事

Sniqow12/26 06:35看過註解寫一段佛經的

k79897686912/26 06:48寫註解改code不更新的比較北爛 誤導

louner12/26 08:0140樓那個 不是事先知道那個演算法的人應該都看不懂吧 就

louner12/26 08:01算有註解也一樣

louner12/26 08:03讓人看懂就好 求學時老師說過程式碼不是寫給電腦 是寫給

louner12/26 08:03人看的 這句是真的

passerbycat12/26 08:43丟chatGPT上註解就好了啊

hh123yaya12/26 08:49命名弄好可以省一些 不過同事看不懂英文是另一回事了

ppn12/26 10:52註解重要 但命名更重要 甚至可以犧牲一定效能來遷就可讀性

ppn12/26 10:54不然debug時候你會痛恨一星期前的自己