[熱門文章] 程式設計、重構、與其它任何東西的終極問答

"The Ultimate Question of Programming, Refactoring, and Everything"
網頁版： http://goo.gl/6jIcIp
PDF 版： https://yadi.sk/i/pBZqebxsr5Wyg
#Craftmanships #SoftwareEngineering #CPP #Refactoring #ProgrammingSkills

好的！遲交比不交好，今天的推薦文來了（笑）～

今天介紹這篇，是過去一個禮拜在國外鄉民聚集地 Reddit 程式設計版瘋傳的文章。標題很臭屁「The Ultimate Question of Programming, Refactoring, and Everything」（沒錯！我就在意它最後一個字 "Everything"。咬我啊！ XD）。因為轉載的人實在太多，讓我不禁努力地把它看完了。

其實這篇文章講的是 C/C++ 程式寫作者應該注意、或建議遵守的 42 個小訣竅。既不「Ultimate（終極）」，也不是涵蓋「Everthing」。不過裡面還是有不少中肯的建議，所以我還是將它介紹給大家。

為了讓英文苦手的朋友也能稍微感受一下這篇文章在講什麼，所以我不負責任地快速翻譯了每個標題一下。如果對哪個主題有興趣的，就麻煩大家直接對照標題號碼去看原文解說。原文有些標題用「戲謔」或「隱晦」寫法，我若直接翻譯，大家可能不知道原作者想表達什麼。所以我會將某些標題，用比較易懂的中文重新表達。一切以「標題編號（1~42）」為準。

接下來就請享用我這個不負責任的翻譯了。有會錯原文意思的，還請各位留言在下方、然後鞭小力一點 XD。我會馬上修正的：

1. 不要去做編譯器會做的事情
如：用迴圈能存取 a[0] ~ a[9]，就不要用「拷貝貼上」a[0], a[1], a[2]..., a[9] 來存取裡面的內容值。

2. 大於 0 不代表它等於 1
若文件告訴你某函數執行成功會傳回「大於0」的值、但目前這個大於0的值是「1」。請你寫程式的時候不要自作聰明地偵測「傳回值 == 1」當成成功，請乖乖遵照規格書用「傳回值 > 0」等於成功。因為將來的版本有可能還會傳回 2, 3...等其他值。

3. 當你拷貝貼上一段程式碼，記得檢查它的副本兩遍
有時候你拷貝貼上一段程式碼，會忘了去修改裡面一些不同的小數字，導致花了大把時間去檢查錯誤到底出現在哪裡。

4. 小心使用「? :」運算子。並記得多加括號
「? :」是 C/C++ 內常用的運算子。若您寫了一段這樣的原始碼「a - b?0:1」，您可能以為它是這樣運作的「a - (b?0:1)」，事實上，它是這樣運作的「(a-b)?0:1」。結論是，多加括號保平安。

5. 多用市面上有的工具來分析您的原始碼
市面上有些工具，如：原始碼靜態分析工具、原始碼排列工具...可以幫您在把原始碼送入編譯器前，就抓到錯誤。不過作者也提到，別以為倚賴這些工具，錯誤就不會發生。真正要減少錯誤還是得靠多讀規格書，增加程式寫作經驗才辦得到。

6. 確認您所有的指標，都已經轉型成整數型態
作者擔心，某些使用 64 bits 當成指標變數寬度的系統，到 32 bits 的機器內重新編譯時，會產生高位元組被截斷的慘劇。某些編譯器提供「uintptr_t」這個專門給指標變數使用的型態，會隨著編譯器所在的環境，自動調整指標寬度。

7. 別在迴圈內呼叫「alloca()」這個函數
萬一迴圈失控，alloca() 函數會霸佔大量記憶體無法釋放。建議事先在迴圈外霸佔一大塊足夠的記憶體，然後在迴圈內慢慢蠶食之。

8. 在「解構函數（Destructor）」內使用「例外處理（Exception）」是很危險的！
作者認為，在負責釋放記憶體、收尾等工作的解構函數，還去霸佔新記憶體作事情是不好的。若真的發生例外（Exception），直接「吃掉（Supress）」不要讓它出現在使用者面前可能還比較好。

9. 若你要比對字串結尾，請用 '\0' 代表
有些程式設計師因為 '\0' 其實就是數字 0，而在比對字串結尾時，直接使用 0 來比對字串結尾。作者認為這個習慣不好。

10. 請勿濫用 # ifdef
# ifdef 很好用，但很容易讓原始碼雜亂難讀。作者不會建議大家不要用，但他反對連可以用 if ~ else 解決的場合，都濫用 # ifdef。

11. 別把一堆運算子全都擠在同一列
多分成幾列，Debugger 可以比較容易指出發生錯誤的是在哪個環節。

12. 當你「拷貝貼上」程式碼時，特別注意「最後一列效應」
作者還是不太建議濫用拷貝貼上，他認為需要重複使用一段程式碼，不如好好考慮寫成稍有彈性的函數，然後重複叫用。此外，他建議大家去看「最後一列效應」這篇文章（連結在本文），並了解最後一列效應在拷貝貼上程式碼內，所扮演的角色。

13. 程式碼若很長，盡量多折幾列，然後排成像表格般一樣整齊（Table-style）

14. 好編譯器 + 好的寫碼習慣是不夠的
內文舉了個後括號「)」括錯位置，但編譯器抓不出來的例子。

15. 若有一堆意義相關的常數，請用 enum 括住它們

16. 「看我能把程式碼寫得這麼屌！」的炫耀寫碼心態不可取
寫程式碼要以「穩」「易讀」為主，不是把一些剛學不久，覺得很酷，但三個月後會忘個精光的技術用進程式碼內。

17. 想用程式碼把一塊資料清乾淨，最好把清除程式碼獨立拉出來成一個專屬函數
18. 你在一個語言行得通的方法，在另一個語言不一定行得通
19. 盡量用技巧避免在同一個類別內，建構函數彼此呼叫的情況
20. 讀檔時，只檢查有沒有讀到檔尾（EOF）似乎是不夠的
21. 正確檢查 EOF 的方法
22. 有比使用 # pragma warning(...) 來印錯誤訊息更好的方法，勿濫用
23. 如果你想取得字串長度，用函數自動幫你算，別用手算然後硬填數字上去
24. 請多使用 "override" 與 "final"，它們會是你的好朋友
25. 別再把 "this" 指標跟 "nullptr"（空指標）拿來作比較
26. 小心使用 VARIANT_BOOL 這個陰險狡猾的東西
27. BSTR（Binary STRing）這個用於微軟 COM/Automation 技術中的資料型態，請小心使用
28. 能用函數把一段程式碼包起來重複用，就別用巨集包它（使用巨集函數的缺點多於優點）
29. 在迴圈或迭代程式碼間，使用 ++i，來取代 i++（i++ 編譯後的執行效能稍微差那麼一點）
30. wprintf() 函數的使用陷阱：Win32 印寬字元字串要用 %S（大寫），Win64 要用 %s（小寫）。
31. 陣列在 C/C++ 傳給函數時，並非是「傳值呼叫」（Call by Value）
32. 要把檔案內的文字直接印在螢幕上時，請不要直接使用 printf() （怕檔案內夾雜 % 開頭的字，這些字對 printf 是有特殊意義的）
33. 想對一個指標取值（亦即：*p），記得檢查它是否為 NULL。否則你對 NULL 取值會導致系統出錯的
34. 別以為 int 的上限 21億+ 很多，在 64 bits 系統中，這個數字很容易爆掉
35. 若您把 enum 常數與 switch~case 連用，增加新元素進 enum 時也別忘了加新 case 進 switch
36. 如果有怎麼抓都抓不出來的 bugs，記得往「記憶體」的方向去思考（32bits vs. 64bits 之類的問題）
37. 在 do~while() 內用 continue 指令要小心，有可能會跳過你放在底部的「更新條件」，導致無窮迴圈
38. 對於指標，請用 nullptr 代替 NULL，這是新的 C++ 規格書希望您遵循的
39. 試著別把一列式子搞得太複雜，這樣比較不會有「咦？為何這段寫錯的程式碼居然可以運作」的問題出現
40. 開始使用「原始碼靜態分析工具」吧！
41. 別為了要使用某函式庫的一個函式，而引進整個函式庫。如果只用了一個函式，建議自己寫比較容易維護。
42. 別再用 empty 這個曖昧的字眼當函數名稱了。用 erase(), clear() 都比 empty() 好。

如果您覺得小弟翻譯了這麼多，沒有功勞也有苦勞，那就麻煩按個讚犒賞小弟一下吧！當然歡迎轉發給您 Facebook 的朋友共同討論。最後提醒一句，上述 42 點別把它們全都當聖旨，親身體會驗證才是最重要的喔！

祝福大家假期愉快！

TQC+Python基礎程式語言應用班第3次上課(106-208)

01_重點回顧與106題公里英哩換算
02_106題公里英哩換算程式說明
03_108座標距離計算程式說明
04_用方法二print加上逗點輸出
05_證照考試介紹與110正n邊形面積計算
06_110正n邊形面積計算程式說明
07_202題倍數判斷程式說明
08_204算術運算程式解說
09_206等級判斷程式說明
10_208十進位換算程式說明

完整教學
http://goo.gl/aQTMFS

吳老師教學論壇
http://www.tqc.idv.tw/

教學論壇(之後課程會放論壇上課學員請自行加入)：
https://groups.google.com/forum/#!forum/tcfst_python_2020_2

TQC+基礎程式語言 (Python 3)證照
Python 第1類：基本程式設計
技能內容：變數與常數、指定敘述、標準輸入輸出、運算式、算術運算子、數學函式的應用、格式化的輸出Python 第2類：選擇敘述
技能內容：if、if...else、if…elifPython 第3類：迴圈敘述
技能內容：while、for…inPython 第4類：進階控制流程
技能內容：常用的控制結構、條件判斷、迴圈Python 第5類：函式(Function)
技能內容：函式使用、傳遞參數、回傳資料、內建函式、區域變數與全域變數

上課用書：
Python 3.x 程式語言特訓教材（第二版）
作者： 蔡明志, 財團法人中華民國電腦技能基金會
出版社：全華
出版日期：2018/12/20
定價：490元

吳老師 109/5/20

EXCEL,VBA,Python,自強工業基金會,EXCEL,VBA,函數,程式設計,線上教學,PYTHON安裝環境

TQC+Python基礎程式語言應用班第3次上課(106-208)

01_重點回顧與106題公里英哩換算
02_106題公里英哩換算程式說明
03_108座標距離計算程式說明
04_用方法二print加上逗點輸出
05_證照考試介紹與110正n邊形面積計算
06_110正n邊形面積計算程式說明
07_202題倍數判斷程式說明
08_204算術運算程式解說
09_206等級判斷程式說明
10_208十進位換算程式說明

完整教學
http://goo.gl/aQTMFS

吳老師教學論壇
http://www.tqc.idv.tw/

教學論壇(之後課程會放論壇上課學員請自行加入)：
https://groups.google.com/forum/#!forum/tcfst_python_2020_2

TQC+基礎程式語言 (Python 3)證照
Python 第1類：基本程式設計
技能內容：變數與常數、指定敘述、標準輸入輸出、運算式、算術運算子、數學函式的應用、格式化的輸出Python 第2類：選擇敘述
技能內容：if、if...else、if…elifPython 第3類：迴圈敘述
技能內容：while、for…inPython 第4類：進階控制流程
技能內容：常用的控制結構、條件判斷、迴圈Python 第5類：函式(Function)
技能內容：函式使用、傳遞參數、回傳資料、內建函式、區域變數與全域變數

上課用書：
Python 3.x 程式語言特訓教材（第二版）
作者： 蔡明志, 財團法人中華民國電腦技能基金會
出版社：全華
出版日期：2018/12/20
定價：490元

吳老師 109/5/20

EXCEL,VBA,Python,自強工業基金會,EXCEL,VBA,函數,程式設計,線上教學,PYTHON安裝環境

文大Python程式入門或證照第1次課程介紹與安裝環境&下載ECLIPSE&設定工作區&安裝PYTHON外掛&編輯環境自行放大與修改編碼方式與轉型&輸出資料型別與型別轉換練習&變數的型別與轉換&證照考題

上課內容：
01_課程介紹與安裝環境
02_下載ECLIPSE說明
03_解壓縮ECLIPSE與設定工作區
04_安裝PYTHON外掛
05_設定PYTHON實體路徑與建立專案
06_編輯環境自行放大與修改編碼方式與轉型
07_輸出資料型別與型別轉換練習
08_變數的型別與轉換
09_證照考題題型說明

完整影音
http://goo.gl/aQTMFS

教學論壇(之後課程會放論壇上課學員請自行加入)：
https://groups.google.com/forum/#!forum/pccu_python_2018_2

懶人包：
EXCEL函數與VBA http://terry28853669.pixnet.net/blog/category/list/1384521
EXCEL VBA自動化教學 http://terry28853669.pixnet.net/blog/category/list/1384524

TQC+Python證照目錄：
Python 第1類：基本程式設計
技能內容：變數與常數、指定敘述、標準輸入輸出、運算式、算術運算子、數學函式的應用、格式化的輸出Python 第2類：選擇敘述
技能內容：if、if...else、if…elif
Python 第3類：迴圈敘述
技能內容：while、for…in
Python 第4類：進階控制流程
技能內容：常用的控制結構、條件判斷、迴圈
Python 第5類：函式(Function)
技能內容：函式使用、傳遞參數、回傳資料、內建函式、區域變數與全域變數
Python 第6類：串列(List)的運作(一維、二維以及多維)
技能內容：串列的建立、串列的函式、串列參數傳遞、串列應用
Python 第7類：數組（Tuple）、集合（Set）以及詞典（Dictionary）
技能內容：數組、集合、詞典的建立、運作及應用
Python 第8類：字串(String)的運作
技能內容：字串的建立、字串的庫存函式、字串的應用
Python 第9類：檔案與異常處理
技能內容：文字I/O、檔案的建立、寫入資料與讀取資料、二進位I/O、編碼（Encoding）、異常處理

課程簡介：入門
建置Python開發環境
基本語法與結構控制
迴圈、資料結構及函式
VBA重要函數到Python
檔案處理
資料庫處理
課程簡介：進階
網頁資料擷取與分析、Python網頁測試自動化、YouTube影片下載器
處理 Excel 試算表、處理 PDF 與 Word 文件、處理 CSV 檔和 JSON 資料
實戰：PM2.5即時監測顯示器、Email 和文字簡訊、處理影像圖片、以 GUI 自動化來控制鍵盤和滑鼠

上課用書：
參考書目
Python初學特訓班(附250分鐘影音教學/範例程式)
作者： 鄧文淵/總監製, 文淵閣工作室/編著
出版社：碁峰? 出版日期：2016/11/29

吳老師 107/12/3

EXCEL,VBA,Python,文化推廣部,EXCEL,VBA,函數,程式設計,線上教學,PYTHON安裝環境