如何寫出符合Python審美的代碼風格?

尋夢新聞LINE@每日推播熱門推薦文章,趣聞不漏接❤️

加入LINE好友

如何寫出符合Python審美的代碼風格? 科技 第1張

作者|Rocky0429,某 985 計算機在讀研究生,ACM 退役狗 & 亞洲區域賽銀獎劃水選手。Python 和算法愛好者,個人公眾號「Python空間」。

寫在之前

每個人都有自己的代碼風格,隨著寫的行數增加,自己對於代碼的審美也會變的不一樣,這就像是一個逐漸蛻變的過程,每過一段時間回頭再去看看自己之前寫的代碼就會生出一種「這麼醜的玩意兒竟然是我寫的」這種感慨。

之前不論是寫 C 或者是 C++ 的時候,對於代碼風格的好壞觀感完全是憑著自己的主觀意識,也沒有什麼官方標準說這樣那樣就是好看的。等學了 Python 以後,神奇的發現 Python 官方竟然給出了一種編碼規範 PEP 8,當然這個只是個標準而已,並沒有強制要求大家都要去遵守,但又好像大多數人都使用了 PEP 8 編碼風格,使它已經成為了事實上的代碼風格標準。

PEP 8 編碼規範

Python 代碼從第一眼看上去,給人的感覺就是簡潔優美,可讀性強,也就是我們日常所說的「高顏值」。一方面是因為 Python 自身的優秀設計,比如統一的鎖進,沒有多餘的符號從而讓代碼變的更加簡潔;另一方面就是因為它有著一套較為統一的編碼風格,當然它本身只是編碼風格方面的建議而不是強制,相應的在編寫 Python 代碼的編輯器自動提供 PFP 8 檢查,當你編寫的代碼違反了 PEP 8 規範的時候,會給出警告信息和修正的建議。與此同時,還有專門的檢查工具對 Python 的代碼風格進行檢查。

由上,還是建議在編寫 Python 代碼的時候都遵循 PEP 8 編碼規範,畢竟你以後不可能是只一個人寫代碼,未來不論是在公司或者某些開源項目中,作為其中的一份子,肯定還是要在風格上向大眾看齊的。

PEP 8 編碼規範詳細的給出了 Python 編碼的指導,包括什麼對齊啦,包的導入順序啦,空格和註釋啦還有命名習慣等方方面面,並且還有詳細的事例。

下面我以「包」的導入為例,看一下 PEP 8 給出的具體編程指導。在 Python 中, import 應該一次只導入一個模塊,不同的模塊應該獨立一行:

importpandasimportnumpy

反面例子:

importpandas,numpy

如果想要從一個模塊里面導入多個,也可以像下面這樣:

fromsubprocessimportPopen,PIPE

import 語句應該處於源碼文件的頂部,位於模塊註釋和文檔字符串之後,全局變量和常量之前。在導入不同的庫的時候,應該按照以下的順序分組,各個分組之間以空行分隔:

  1. 導入標準庫模塊

  2. 導入相關第三方庫模塊

  3. 導入當前應用程序/庫模塊

具體事例如下所示:

importosimporttimeimportpsutilfromtestimportu_test,my_test

Python 中還支持相對導入和絕對導入,在這里還是強推絕對導入。因為絕對導入的可讀性更好一些,也不容易出錯,即使出錯了也會給出更加詳細的錯誤信息。具體如下所示:

fromsub_packageimporttoolsfromsub_package.toolsimportmsg

當然除了上述以外還有更多對於包的規範的描述,PEP 8 的編碼風格指導比較長,並且寫的非常詳細,所以我就不在這一一介紹了,詳細的可以參考 Python 官網上的資料。

pycodestyle 檢查代碼規範

我在上面說過 PEP 8 只是官方給出的 Python 編碼規範,並沒有強制要求大家都遵守,但是又由於大家都在用,所以它也就變成了事實上的 Python 代碼風格標準,既然都是標準了,那麼就應該有工具來檢查這個標準,這樣可以幫助 Python 小白規範自己的代碼,也可以幫助大家在開源或者工作中形成統一的代碼風格。

為了達成上述的目的,官方提供了同名的命令行工具來檢查 Python 代碼是否違反了 PEP 8 規範,並且對違反規範的地方給出了相應的提示信息。

pipinstallpep8

規範的名字是 PEP 8 ,這個檢查代碼風格的命令行工具叫 pep8,這個很容易引起大家的困惑,因此 Python 之父建議將 pep8 重新命名為 pycodestyle,下面我們來看一下 pycodestyle 的用法。

首先通過 pip 安裝一下:

pipinstallpycodestyle

對一個或者多個文件運行 pycodestyle,列印檢查報告:

如何寫出符合Python審美的代碼風格? 科技 第2張

通過 –show-source 顯示不符合規範的源碼,以便工程師進行修改,具體如下所示:

如何寫出符合Python審美的代碼風格? 科技 第3張

autopep8 格式化代碼

autopep8 能夠將 Python 代碼自動格式化為 PEP 8 風格,它使用 pycodestyle 工具來決定代碼中的哪部分需要被格式化,這能夠修復大部分 pycodestyle 工具中報告的排版問題。autopep8 本身也是一個用 Python 寫的工具,所以我們還是可以用 pip 直接安裝:

pipinstallautopep8

它的使用方式也很簡單,具體如下所示:

autopep8--in-placetest_search.py

上述代碼如果不帶 –in-place 的話,會將 autopep8 格式化以後的代碼直接輸出到控制台。我們可以用這種方式檢查 autopep8 的修改,使用 –in-place 則會直接將結果保存到源文件中。在這我繼續用上面的例子中用到的 py 文件,具體如下所示:

如何寫出符合Python審美的代碼風格? 科技 第4張

上面的例子中,autopep8 順利的修復了所有的問題,但是如果你這個時候查看源文件的話,你會發現源文件的內容還是和原來一樣,並沒有被修改。這個時候我們就要用到 –in-place,加上這個選項將不會有任何輸出, autopep8 會直接修改源文件。

autopep8--in-placetest_search.py

(本文為作者投稿,版權歸作者所有。)

福利

掃碼添加小助手微信,回復:1,入群獲取Python電子書(附代碼~~)

如何寫出符合Python審美的代碼風格? 科技 第5張

推薦閱讀:

如何寫出符合Python審美的代碼風格? 科技 第6張

About 尋夢園
尋夢園是台灣最大的聊天室及交友社群網站。 致力於發展能夠讓會員們彼此互動、盡情分享自我的平台。 擁有數百間不同的聊天室 ,讓您隨時隨地都能找到志同道合的好友!