python編碼風格
對於Python,PEP 8 已經成爲大多數項目所遵循的風格指南;它促進了一種非常易讀且令人賞心悅目的編碼風格。每個Python開發人員都應該在某個時候閱讀它;以下是爲你提取的最重要的幾個要點:
-
使用4個空格縮進,不要使用製表符。
-
4個空格是一個在小縮進(允許更大的嵌套深度)和大縮進(更容易閱讀)的一種很好的折中方案。製表符會引入混亂,最好不要使用它。
-
換行,使一行不超過79個字符。這有助於使用小型顯示器的用戶,並且可以在較大的顯示器上並排放置多個代碼文件。
-
使用空行分隔函數和類,以及函數內的較大的代碼塊。
-
如果可能,把註釋放到單獨的一行。
-
使用文檔字符串。
-
在運算符前後和逗號後使用空格,但不能直接在括號內使用: a = f(1, 2) + g(3, 4)。
-
類和函數命名的一致性;規範是使用 CamelCase 命名類,lower_case_with_underscores 命名函數和方法。始終使用 self 作爲第一個方法參數的名稱(有關類和方法,請參閱 初探類 )。
-
如果你的代碼旨在用於國際環境,請不要使用花哨的編碼。Python 默認的 UTF-8 或者純 ASCII 在任何情況下都能有最好的表現。
-
同樣,哪怕只有很小的可能,遇到說不同語言的人閱讀或維護代碼,也不要在標識符中使用非ASCII字符。