2008/06/04

[Programming] 程式寫作十點常見錯誤提醒

下面十點是我也常犯的程式寫作的錯誤,大部份的情況是 javascript 上面的,不過寫完了之後覺得在其它程式語言上面也適用,所以就擴大解釋條文(... 不是釋憲...):
• 不一致的 function 命名原則 (camel, c style, SVO, VSO...)
• 不一致(重複)的變數命名
• 不一致的檔案編碼(big5 or utf8) 或檔案儲存格式 (包括換行記號及 endian)
• 重複的功能 (沒有模組化﹑不能合理的 reuse)
• document.write/innerHTML 的濫用 (用 document.write 的好處是快速建立,然而卻不好維護, content 也開始混亂)
• 不一致的 indent (2,4,8 都可以,但是要一致,也不該有除了 2,4,8 以外的 tabspace/expandtab )
• function 位置的混亂 (性質相近的 function 應該放在一起)
• 多餘的註解, 中文註解
• 過度依賴工具,忽略了基本元素: css 就是做樣板的基本工具。 (了解 css 的使用方式做出來的樣板才會"簡潔有力")
• 關鍵字的符號間隔 (style)

沒有留言:

[Windows] git-bash 底下的工具

因為工作轉到 Windows 平台上的關係,所以很多工具改到 Windows 上面運作,跟著在 TortoiseGit 底下使用 git-bash 來維護自己的專案原始碼。結果就是裝了前面提過的 auto-hotkey 使用熱鍵來提昇自己的平台操作速度; 但除了 hotkey...