每過一段時間,我都能讀到一些好東西,它是如此的深刻見解,寫的如此的清晰,如此的條理,我必須把它收錄進我的個人“史上最佳”聖物集裡。最近,我新收錄了一篇,非常棒的一篇叫做《Best Practices for Scientific Computing》的文章,我希望每個來讀本文的讀者都找個時間讀讀它。我在這裡列出它的要點,是要鼓勵你去閱讀完整的全文。寫的真是非常好。
1. 給人寫程式,而不是給電腦。
1. 一個程式,對於閱讀它的人來說,不應該要求讀者一次性的在大腦裡加載過多的背景/相關知識。
2. 命名需要一貫、明確、有意義
3. 程式碼風格和格式要統一一致
4. 軟體開發中的各種工作都要分割成1小時左右的任務
2. 重複性的工作自動化。
1. 讓電腦去做重複性的工作
2. 把最近使用過的命令存到一個文件裡,以備復用
3. 使用編譯工具來自動化系統流程
3. 用電腦做歷史記錄
1. 用軟體工具來自動跟踪電腦的工作
4. 逐步改進。
1. 每次做一小步,及時獲得反饋,及時糾正
5. 使用版本控制。
1. 使用一個版本控制系統
2. 所有由手工創建的東西都要放到版本控制系統裡
6. 不要重複自己(或他人)。
1. 系統中的每一段數據都要有一個權威的單一的存在
2. 程式碼應該模塊化復用,而不是複製貼上
3. 復用程式碼,而不是重寫程式碼
7. 準備好對付錯誤的方法
1. 在程式中增加斷言,檢查它們的各種操作
2. 使用現成的單元測試框架
3. 測試程式時藉鑑所有的可用的經驗
4. 把bug做成測試用例
5. 使用一個有程式碼指令的調試工具
8. 只在軟體能正確的工作後才可優化。
1. 使用監控工具找到瓶頸
2. 盡可能的用高級語言寫程式
9. 文檔裡描述的應該是設計思路和目的,而不是技術細節。
1. 描述接口和原因,而不是實現
2. 重構程式碼,而不是註釋解釋運行原理
3. 引用其它程式時嵌入其它程式的文檔
10. 協作
1. 程式碼合併前進行程式碼審查
2. 當幫帶新成員或解決特別詭異的問題時使用結對編程
我要額外提到的是這個:
11. 維護舊程式碼。
如果你還在猶豫不決是否去看那篇文章,那你先去看看它裡面列出的引用67部關於電腦的著作和文章。正如我說的,這篇文章是“史上最佳”。
英文原文:http://server.dzone.com/articles/best-best-practices-ever
留言列表