1. 縮進
是通過縮進來表示代碼塊的,因此縮進應該是 4 個空格。不要使用 Tab,因為在不同的編輯器中,Tab 可能會被解釋成不同數量的空格。
2. 行寬
每行代碼的長度應該不超過 79 個字符。如果一行代碼超過了這個長度,可以使用括號或反斜杠來進行換行。在使用括號或反斜杠進行換行時,應該將它們放在行末。
3. 空行
在函數和類之間應該有兩個空行。在類的方法之間應該有一個空行。在函數或方法內部,可以使用空行來分隔代碼塊,以提高可讀性。
4. 導入
中,應該盡量避免使用通配符導入,因為這會導致命名空間污染。應該只導入需要的模塊和函數。多個導入應該分別寫在不同的行上。
5. 命名
變量和函數名應該使用小寫字母,單詞之間用下劃線分隔。類名應該使用駝峰命名法,即單詞首字母大寫,其余字母小寫。
6. 注釋
注釋應該使用英文,并在代碼的上方或右側進行注釋。注釋應該簡明扼要,不要重復代碼功能。如果代碼發生變化,注釋也應該隨之進行修改。
7. 函數
8. 異常
ally 結構,并在 except 中處理特定的異常。如果需要拋出異常,應該使用 raise。
9. 其他
特有的語法糖,以提高代碼的可讀性和可維護性。
代碼非常重要。應該遵守以上規范和要求,以提高代碼的質量和可維護性。