Re: [問卦] 如何寫自己容易維護 別人難懂的CODE
※ 引述《cosmite (焼き団子)》之銘言:
: 以前我寫CODE
: 都會把 段落註解 跟 方程式功能 寫得清清楚楚
: 後來 主管以為時間到CODE就會出來 對員工也越來越不尊重
: 重用嘻嘻哈哈會捧懶的員工
: 受不了了
: 自此註解都不再寫 但是元件命名 常數定義還是寫得很清楚
: 現在想要建造城牆 讓CODE不容易讀 不容易被理解
: 如何寫自己容易維護 別人難懂的CODE ?
: 多使用MACRO巨集 ? 把一個程式拆成多個小程式 ? 程式繞來繞去 ?
: 元件命名用簡寫 自己要看再查表 會不會造成自己困擾 ?
: 有卦嗎
很簡單啊
你的註解另外開一個說明檔案就好
正常來說註解都是寫在程式段落附近
你可以把註解當成說明文件就好,另外開一個檔案
然後每一個功能元件或者功能段落理論上你會開不同的程式包
每個程式包的說明也都分別獨立出來,不要寫成一個大檔
最後再開一個檔案把每個功能串起來,想看的時候就會叫出來看就好。
阿這些說明文件你交付程式的時候就收好不要放出去,只要你自己有在維護這些程式說明,最後這些說明就會只要你自己看得懂。
但實際上這就會變成你要自己維護一個字典系統跟程式文件館
通常弄到最後你會自己崩潰
為什麼會崩潰…?
因為隨著程式增修,這些東西會越來越複雜
但你改了其中一個元件很有可能全部說明都要動
但很有可能你會漏掉某些該更新的說明
幾次之後通常你就會找不到哪裡忘記更新了
我碰過的專案,即使有專門的團隊在維護字典跟說明檔案,都會出現版控問題
更不要說只有一個人…
要做不是不行
但你自己考慮好..
--
所以像clean code之類的書籍都是在說別寫
註解了
多人合作專案還是免不了要寫啦 不寫很難合作…
※ 編輯: ARCHERDEVIL (114.37.158.17 臺灣), 10/05/2021 20:05:00有時候我真的很懷疑那些clean code大師
有沒有真的在無交接的狀況下維護其他人
沒有註解沒有文件的code
我也很懷疑這件事情 小專案或者功能單純的專案應該可以 但成千上萬個功能元件的專案無註解一定幹到飛起來…
※ 編輯: ARCHERDEVIL (114.37.158.17 臺灣), 10/05/2021 20:13:29不寫註解就是純粹用function name及考驗
看code能力了吧 有些沒能力的自然看不懂
但常常遇到的狀況是 你CODE在幹麻都懂
但CODE要解決什麼狀況根本看不出來
然後你處理特定狀況的code用完之後點掉 之後的人就會覺得為什麼要多寫這段又點掉 時間久了之後所有人還會都忘記答案… 最後變成懸案…
※ 編輯: ARCHERDEVIL (114.37.158.17 臺灣), 10/05/2021 20:17:36CODE看的懂,但CODE的目的看不懂XDD
很常見啊 舉例說明 某公司裡面有一台電腦裝了某個版本的軟體 而這個軟體雖然EOS但因為業務需求不能廢 所以要存取該軟體的程式功能必須加上一小段程式才能特別處理。 半年後那個EOS的軟體終於廢止 所以相應的程式段落就被點掉。 五年後新來的回頭看某一段程式 發現有一段程式沒有註解 看起來完全沒有作用也沒有點掉… 但去問所有人,沒有人記得那一段是幹嘛的…
※ 編輯: ARCHERDEVIL (114.37.158.17 臺灣), 10/05/2021 20:55:27啊是沒有git嗎?
Py的話,我真的很討厭Decorator,用得
妙精簡,用得差幹扣怎麼會動。
爆
Re: [問卦] 25歲長5顆大腸瘜肉484很扯爆
[問卦]副站長發文拿槍指著大家 是什麼意思?爆
[問卦] 猜猜新竹市這一碗多少錢?64
Re: [問卦] 范姊研究員Threads暴走中58
Re: [新聞] 拿希特勒、納粹影射賴清德!德國外媒:53
[問卦] 范琪斐是不是已經開始後悔了52
Re: [問卦] 范姊研究員Threads暴走中56
[問卦] 高普考不香了?爆
Re: [問卦] 范姊研究員Threads暴走中37
[問卦] 不讓陸資入股 台灣IC業2025將消失的八卦39
[問卦] 台裔波士頓女市長:偷竊搶劫不該入罪。34
[問卦] 高鐵商務艙闖入未購票者處理方式爆
Re: [問卦] 越南女學生的制服比水手服頂吧?37
[問卦] 如果八仙重新開幕 還會去嗎32
[問卦] 今年股票賺了400萬要買什麼車?36
[問卦] 魔物獵人除了太刀還有啥好玩的嗎30
[問卦] 冴羽獠有哪個完美的人選可以演真人版?29
[問卦] 大谷 和 車銀優 你來生更想當誰?27
[爆卦] 黃仁勳預計晚上8點搭乘私人飛機離台26
[問卦] 范琪斐是藍是綠是白= =44
[問卦] 每天喝代糖飲料,糖化血色素還上升原因?24
[問卦] 郭台銘跟黃仁勳的故事誰比較勵志?41
[問卦] 台北人真的搞得清楚A7 A8 A9這些站在哪嗎爆
[問卦] 可口美酥這層凹槽是幹嘛用的?22
[問卦] 愛之味甜辣醬你真的喜歡嗎23
[問卦] 北辰天狼刃是最中二武器名嗎?21
[問卦] 現在買台積電會太晚嗎?34
[問卦] 台鐵和郵局那個會先賺錢?17
[問卦] 一粒在拍照時候 後面啦啦隊在想什麼?18
[問卦] 如果沒台灣科技業,全世界會倒退20年嗎