PEP 8 摘要

 

 

1. 設置代碼格式

　　隨着你編寫的程序愈來愈長，有必要了解一些代碼格式設置約定。請花時間讓你的代碼竟可能易於閱讀；讓代碼易於閱讀有助於你掌握程序是怎麼作的，也能夠幫助他人理解你編寫的代碼。

　　爲確保全部人編寫的代碼的結構都大體一致，Python程序員都遵循一些格式設置約定。學會編寫整潔的Python後，就能夠明白他人編寫的Python代碼的總體結構——這要他們和你遵循相同的指南。要成爲裝也程序員，應從如今開始就遵循這些指南，以養成良好的習慣。

 

2. 格式設置指南

　　如果要提出Python語言修改建議，須要編寫Python改進提案（Python Enhancement Proposal ,PEP）。PEP 8是最古老的PEP之一，它向Python程序員提供了代碼格式設置指南。PEP 8的篇幅很長，可是大部分與複雜的代碼結構相關。

　　Python格式設置指南的編寫者深知，代碼被閱讀的次數比編寫的次數多。代碼編寫出來後，調試時你須要閱讀它；給程序添加新功能是，須要花很長的時間閱讀代碼；與其餘程序員分享代碼時，這些程序員也將閱讀它們。

　　若是必定要在讓代碼在易於編寫和易於閱讀之間作出選擇，Python程序員幾乎老是會選擇後者。下面的指南能夠幫助你從一開始就編寫出清晰的代碼。

 

3. 縮進

　　PEP 8建議每級縮進都是用四個空格，這既能夠提升可讀性，又留下了足夠的多級縮進空間。

　　在字處理文檔當中，你們經常使用製表符而不是空格來縮進。對於字處理文檔來講，這樣作的效果很好，可是混合使用製表符和空格會讓Python解釋器感到迷惑。每款文本編輯器都提供了一種設置，能夠將輸入的製表符轉換爲指定數量的空格。你在編寫代碼時應該使用製表符鍵，可是必定要對編輯器進行設置，使其在文檔之中插入空格而不是製表符。

　　在程序當中混合使用製表符和空格可能致使極難解決的問題。若是你混合使用了製表符和空格，能夠將文件當中全部的製表符轉換爲空格，大多數編輯器都提供了這樣子的功能。

4. 行長

　　不少Python程序員都建議每行不超過80字符。最初制定這樣的指南時，在大多數計算機當中，終端窗口每行只能容納79字符；當前，計算機屏幕每行能夠容納的字符數量多得多，爲什麼還要使用79字符的標準行長呢？這裏有別的緣由。專業的程序員一般會在同一個屏幕上打開多個文件，使用標準行長可讓他們在屏幕上並排打開兩三個文件時可以同時看到各個文件的完整行。PEP 8還建議註釋的行長不超過72字符，由於有一些工具爲大型項目自動生成文檔時，會在每一行註釋開頭添加格式化字符。

　　PEP 8當中有關行長的指南並不是是不可逾越的紅線，有一些小組將最大行長設置爲99字符。在學習期間，你不用過多地考慮代碼的行長，可是也別忘了，協做編寫程序時，你們幾乎都遵照PEP 8指南。在大多數編輯器當中，均可以設置一個視覺標誌——一般是一條豎線，讓你知道不能越過的界線在什麼地方。

 

5. 空行

　　要將程序的不一樣部分分開，可使用空行。你應該使用空行來組織程序文件，可是也不能濫用；只要掌握其中的平衡。例如，若是你有5行建立列表的代碼，還有3行處理該列表的代碼，那麼用一個空行將這兩部分隔開是合適的。然而，你不該使用三四個空行將它們隔開。

　　空行雖然不會影響到代碼的運行，可是會影響到代碼的可讀性。Python解釋器根據水平縮進狀況來解讀代碼，但不關心垂直間距。