[格言] プログラマーの格言

看板NIHONGO (日語板)作者 (タシロス・シェン)時間17年前 (2008/11/11 13:11), 編輯推噓1(103)
留言4則, 2人參與, 最新討論串34/77 (看更多)
詳細設計はソース内のコメントにて完結する. コメントだけが唯一の自衛手段であるから, 少なくとも本人が理解できるように書かれている. ※註解 對程式設計師來說, 真正的詳細設計並不是從系統工程師手裡拿到的那份, 而是紀錄在程式碼裡面的註解。 因為從系統工程師裡面拿到的那份, 並非是以程式設計師的觀點來看, 而是以系統工程師的觀點所做的。 而程式碼基本上,就有如作文一般, 一樣的設計,也會出現很多種不同的寫法, 因為程式碼裡面,會參雜著程式設計師的個性,以及習慣。 所以一般來說,去讀解別人所寫的程式碼是一件很困難的事情。 就連自己寫過的程式碼,過半年之後再來看, 自己都不一定能看的懂了,更何況是別的程式設計師寫的程式碼呢? 所以為了防止這樣的問題發生,程式設計師們會把詳細設計寫成註解。 因為至少讀解自己寫過的註解,比讀解自己寫過的程式碼, 還要來的簡單多了。 -- ████ ◥◤ ◢ ████ ████ ◥◤ ◢ ◣ █ █ █ █ █ ◢◤ █ ███ ◥◤ █ ◤◥◣█ ◥◤ █ █ █ ◢◤◣ ◥◤ █ █ █ ◢◤ ◢██◤ ████ ◢◤ █ ◢██◤ ███ ◢██◤ -- ※ 發信站: 批踢踢實業坊(ptt.cc) ◆ From: 125.197.234.21

11/11 17:15, , 1F
詳細設計僅存於程式碼內的附註。附註是唯一的自衛手段,
11/11 17:15, 1F

11/11 17:15, , 2F
至少那是為了讓我看懂而寫的。
11/11 17:15, 2F

11/16 12:10, , 3F
詳細設計要在程式碼的註解裡做完。
11/16 12:10, 3F

11/16 12:10, , 4F
註解是唯一的自衛手段,至少要讓自己看懂。
11/16 12:10, 4F
文章代碼(AID): #196HG1g1 (NIHONGO)
討論串 (同標題文章)
文章代碼(AID): #196HG1g1 (NIHONGO)