標籤:class 執行個體 工作 單詞 哪些 關鍵字 標準庫 通過 而且
pep8 通常會聽別人提到,但是具體的指什麼內容呢,簡單介紹下。
《Python Enhancement Proposal #8》 (8號python增強提案)又叫PEP8,他針對的python代碼格式而編訂的風格指南。
空白
- 使用space來表示縮排,而不要用tab
- 和文法相關的每一層縮排用4個空格來表示
- 每行的字元數不應超過79
- 檔案中函數與類之間應該用兩個空行隔開
- 在同一個類中,各方法之間應用一個空行隔開
- 在使用下表來擷取列表元素、調用函數或給關鍵字參數賦值的時候,不要在兩旁添加空格
- 為變數賦值的時候,賦值符號的左側和右側應該各自寫上一個空格,而且只要一個就好
命名
- 函數、變數及屬性應該用小寫字母來拼字,各單詞之間以底線相連
- 類與異常,應該以每個單詞首字母均大寫的格式來命名
- 類中的執行個體方法,應該把首個參數命名為self,以表示該對象的自身
- 類方法的首個參數,應該命名為cls,以表示該類自身
運算式和語句
- 採用內聯式的否定詞,而不要把否定詞放在整個運算式的前面,例如,應該寫if a is not b 而不是if not a is b
- 不要通過檢測長度的辦法(如 if len(somelist) == 0)來判斷somelist是否為空白值,而是應該採用 if not somelist 這種寫法來判斷,他會假定:空值將自動評估為False
- 不要編寫單行的if語句,for迴圈,while迴圈及except複合陳述式,而是應該把這些語句分成多行來書寫,以示清晰
- import語句應在總放在檔案開頭
- 檔案中的哪些import語句應該按照順序劃分為三個部分,分別表示標準庫模組,第三方模組以及自用模組
要點
- 當編寫Python代碼時,總應該遵循PEP8風格指南
- 與廣大Python開發人員採用同一套代碼風格,可以使項目更利於多人協作
- 採用一直的風格來編寫代碼,可以領後續的修改工作變得更為容易
【轉】Python Enhancement Proposal #8【PEP8】