Python程序員的30個(gè)常見(jiàn)錯誤

　　文章中，我將總結新老Python程序員常犯的一些錯誤，以幫助你們在自己的工作避免犯同樣或類(lèi)似錯誤。

　　首先我要說(shuō)明一下的是，這些都是來(lái)源于第一手的經(jīng)驗。我以講授Python的知識為生。在過(guò)去的7年里，我已經(jīng)給上千名學(xué)生講授上百堂Python的課程，同時(shí)看著(zhù)這些學(xué)生們犯同樣的錯。也就是說(shuō)，這些是我看著(zhù)Python初學(xué)者活生生犯的錯，千百次的錯。

　　事實(shí)上，這些錯誤實(shí)在是太普遍了以至于我敢保證你剛開(kāi)始學(xué)的時(shí)候是一定會(huì )犯的。

　　“那么是什么呢?”你會(huì )問(wèn)，“你也會(huì )在Python里犯那么多錯么?”是的。Python可能是最簡(jiǎn)單、最靈活的語(yǔ)言之一，但它終究還是一門(mén)編程語(yǔ)言。它仍然有語(yǔ)法，數據類(lèi)型，以及巫師蒂姆居住的黑暗角落。

　　典故出自《蒙蒂派森與圣杯》中的魔法師蒂姆，他主角們指點(diǎn)在洞穴的墻壁上記錄的圣杯位置，作者在此處的意思是Python語(yǔ)言里容易犯錯的地方。另，Python語(yǔ)言得名于作者Guido van Rossum特別喜歡的《蒙蒂派森飛行馬戲團(Monty Python’s Flying Circus)》——譯者注

　　好事情是多虧了Python那干凈的設計，一旦你學(xué)會(huì )了Python，你就能自動(dòng)的避開(kāi)很多陷阱。Python在其各組件之間有著(zhù)最小的互動(dòng)，這能有效的減少bug。它也擁有十分簡(jiǎn)單的語(yǔ)法，這意味著(zhù)在一開(kāi)始你就有更小的概率犯錯。當你實(shí)在是犯了錯的時(shí)候，Python的即時(shí)錯誤檢測和報告能幫你迅速的恢復。

　　但用Python編程也不是個(gè)自動(dòng)完成的活兒，很多事還是要早做準備。那么廢話(huà)不多說(shuō)了，讓我們直切正題。在接下來(lái)的三節里我們將這些錯誤分為語(yǔ)用、代碼，以及編程三個(gè)大類(lèi)。

　　如果你想讀到更多的Python的常見(jiàn)錯誤以及如何避免它們，那么在O’Reilly系列叢書(shū)的《Python學(xué)習手冊》(原書(shū)第5版)里有詳細的解讀。

　　01 語(yǔ)用錯誤

　　讓我們從基礎開(kāi)始，從那些剛學(xué)習編程的人鉆研語(yǔ)法之前碰到的事情開(kāi)始。如果你已經(jīng)編過(guò)一些程了，那么以下這些可能看起來(lái)十分的簡(jiǎn)單;如果你曾經(jīng)嘗試過(guò)教新手們怎么編程，它們可能就不這么簡(jiǎn)單了。

　　1. 在交互提示符中輸入Python代碼

　　在>>>交互提示符中你只能輸入Python代碼，而不是系統命令。時(shí)常有人在這個(gè)提示符下輸入emacs，ls，或者edit之類(lèi)的命令，這些可不是Python代碼。

　　在Python代碼中確實(shí)有辦法來(lái)調用系統命令(例如os.system和os.popen)，但可不是像直接輸入命令這么直接。如果你想要在交互提示符中啟動(dòng)一個(gè)Python文件，請用import file，而不是系統命令python file.py。

　　2. Print語(yǔ)句(僅僅)是在文件中需要

　　因為交互解釋器會(huì )自動(dòng)的講表達式的結果輸出，所以你不需要交互的鍵入完整的print語(yǔ)句。這是個(gè)很棒的功能，但是記住在代碼文件里，通常你只有用print語(yǔ)句才能看得到輸出。

　　3. 小心Windows里的自動(dòng)擴展名

　　如果你在Windows里使用記事本來(lái)編輯代碼文件的話(huà)，當你保持的時(shí)候小心選擇“所有文件”(All Files)這個(gè)類(lèi)型，并且明確的給你的文件加一個(gè).py的后綴。不然的話(huà)記事本會(huì )給你的文件加一個(gè).txt的擴展名，使得在某些啟動(dòng)方法中沒(méi)法跑這個(gè)程序。

　　更糟糕的是，像Word或者是寫(xiě)字板一類(lèi)的文字處理軟件還會(huì )默認的加上一些格式字符，而這些字符Python語(yǔ)法是不認的。

　　所以記得，在Windows下總是選“所有文件”(All Files)，并保存為純文本，或者使用更加“編程友好”的文本編輯工具，比如IDLE。在IDLE中，記得在保存時(shí)手動(dòng)加上.py的擴展名。

　　4. 在Windows下點(diǎn)擊圖標的問(wèn)題

　　在Windows下，你能靠點(diǎn)擊Python文件來(lái)啟動(dòng)一個(gè)Python程序，但這有時(shí)會(huì )有問(wèn)題。首先，程序的輸出窗口在程序結束的瞬間也就消失了，要讓它不消失，你可以在文件最后加一條raw_input()的調用。另外，記住如果有錯的話(huà)，輸出窗口也就立即消失了。

　　要看到你的錯誤信息的話(huà)，用別的方法來(lái)調用你的程序：比如從系統命令行啟動(dòng)，通過(guò)提示符下用import語(yǔ)句，或者IDLE菜單里的選項，等等。

　　5. Import只在第一次有效

　　你可以在交互提示符中通過(guò)import一個(gè)文件來(lái)運行它，但是這只會(huì )在一個(gè)會(huì )話(huà)中起一次作用;接下來(lái)的import僅僅是返回這個(gè)已經(jīng)加載的模塊。要想強制Python重新加載一個(gè)文件的代碼，請調用函數reload(module)來(lái)達到這個(gè)目的。注意對reload請使用括號，而import不要使用括號。

　　6. 空白行(僅僅)在交互提示符中有作用

　　在模塊文件中空白行和注釋統統會(huì )被忽略掉，但是在交互提示符中鍵入代碼時(shí)，空白行表示一個(gè)復合語(yǔ)句的結束。

　　換句話(huà)說(shuō)，空白行告訴交互提示符你完成了一個(gè)復合語(yǔ)句;在你真正完成之前不要鍵入回車(chē)。事實(shí)上當你要開(kāi)始一個(gè)新的語(yǔ)句時(shí)，你需要鍵入一個(gè)空行來(lái)結束當前的語(yǔ)句——交互提示符一次只運行一條語(yǔ)句。

　　02 代碼錯誤

　　一旦你開(kāi)始認真寫(xiě)Python代碼了，接下來(lái)了一堆陷阱就更加危險了——這些都是一些跨語(yǔ)言特性的基本代碼錯誤，并常常困擾不細心的程序員。

　　7. 別忘了冒號

　　這是新手程序員最容易犯的一個(gè)錯誤：別忘了在復合語(yǔ)句的起始語(yǔ)句(if，while， for等語(yǔ)句的第一行)結束的地方加上一個(gè)冒號“：”。也許你剛開(kāi)始會(huì )忘掉這個(gè)，但是到了很快這就會(huì )成為一個(gè)下意識的習慣。課堂里75%的學(xué)生當天就可以記住這個(gè)。

　　8. 初始化變量

　　在Python里，一個(gè)表達式中的名字在它被賦值之前是沒(méi)法使用的。這是有意而為的：這樣能避免一些輸入失誤，同時(shí)也能避免默認究竟應該是什么類(lèi)型的問(wèn)題(0，None，””，[]，?)。記住把計數器初始化為0，列表初始化為[]，以此類(lèi)推。

　　9. 從第一列開(kāi)始

　　確保把頂層的，未嵌套的代碼放在最左邊第一列開(kāi)始。這包括在模塊文件中未嵌套的代碼，以及在交互提示符中未嵌套的代碼。Python使用縮進(jìn)的辦法來(lái)區分嵌套的代碼段，因此在你代碼左邊的空格意味著(zhù)嵌套的代碼塊。除了縮進(jìn)以外，空格通常是被忽略掉的。

　　10. 縮進(jìn)一致

　　在同一個(gè)代碼塊中避免講tab和空格混用來(lái)縮進(jìn)，除非你知道運行你的代碼的系統是怎么處理tab的。否則的話(huà)，在你的編輯器里看起來(lái)是tab的縮進(jìn)也許Python看起來(lái)就會(huì )被視作是一些空格。保險起見(jiàn)，在每個(gè)代碼塊中全都是用tab或者全都是用空格來(lái)縮進(jìn);用多少由你決定。

　　11. 在函數調用時(shí)使用括號

　　無(wú)論一個(gè)函數是否需要參數，你必須要加一對括號來(lái)調用它。即，使用function()，而不是function。Python的函數簡(jiǎn)單來(lái)說(shuō)是具有特殊功能(調用)的對象，而調用是用括號來(lái)觸發(fā)的。像所有的對象一樣，他們也可以被賦值給變量，并且間接的使用他們：x=function:x()。

　　在Python的培訓中，這樣的錯誤常常在文件的操作中出現。通常會(huì )看到新手用file.close來(lái)關(guān)閉一個(gè)問(wèn)題，而不是用file.close()。因為在Python中引用一個(gè)函數而不調用它是合法的，因此不使用括號的操作(file.close)無(wú)聲的成功了，但是并沒(méi)有關(guān)閉這個(gè)文件!

　　12. 在Import時(shí)不要使用表達式或者路徑

　　在系統的命令行里使用文件夾路徑或者文件的擴展名，但不要在import語(yǔ)句中使用。即，使用import mod，而不是import mod.py，或者import dir/mod.py。

　　在實(shí)際情況中，這大概是初學(xué)者常犯的第二大錯誤了。因為模塊會(huì )有除了.py以為的其他的后綴(例如，.pyc)，強制寫(xiě)上某個(gè)后綴不僅是不合語(yǔ)法的，也沒(méi)有什么意義。

　　和系統有關(guān)的目錄路徑的格式是從你的模塊搜索路徑的設置里來(lái)的，而不是import語(yǔ)句。你可以在文件名里使用點(diǎn)來(lái)指向包的子目錄(例如，import dir1.dir2.mod)，但是最左邊的目錄必須得通過(guò)模塊搜索路徑能夠找到，并且沒(méi)有在import中沒(méi)有其他路徑格式。

　　不正確的語(yǔ)句import mod.py被Python認為是要記在一個(gè)包，它先加載一個(gè)模塊mod，然后試圖通過(guò)在一個(gè)叫做mod的目錄里去找到叫做py的模塊，最后可能什么也找不到而報出一系列費解的錯誤信息。

　　13. 不要在Python中寫(xiě)C代碼

　　以下是給不熟悉Python的C程序員的一些備忘貼士：

　　在if和while中條件測試時(shí)，不用輸入括號(例如，if (X==1):)。如果你喜歡的話(huà)，加上括號也無(wú)妨，只是在這里是完全多余的。

　　不要用分號來(lái)結束你的語(yǔ)句。從技術(shù)上講這在Python里是合法的，但是這毫無(wú)用處，除非你要把很多語(yǔ)句放在同一行里(例如，x=1; y=2; z=3)。

　　不要在while循環(huán)的條件測試中嵌入賦值語(yǔ)句(例如，while ((x=next() != NULL))。在Python中，需要表達式的地方不能出現語(yǔ)句，并且賦值語(yǔ)句不是一個(gè)表達式。

　　03 編程錯誤

　　下面終于要講到當你用到更多的Python的功能(數據類(lèi)型，函數，模塊，類(lèi)等等)時(shí)可能碰到的問(wèn)題了。由于篇幅有限，這里盡量精簡(jiǎn)，尤其是對一些高級的概念。要想了解更多的細節，敬請閱讀《Python學(xué)習手冊》。

　　14. 打開(kāi)文件的調用不使用模塊搜索路徑

　　當你在Python中調用open()來(lái)訪(fǎng)問(wèn)一個(gè)外部的文件時(shí)，Python不會(huì )使用模塊搜索路徑來(lái)定位這個(gè)目標文件。它會(huì )使用你提供的絕對路徑，或者假定這個(gè)文件是在當前工作目錄中。模塊搜索路徑僅僅為模塊加載服務(wù)的。

　　15. 不同的類(lèi)型對應的方法也不同

　　列表的方法是不能用在字符串上的，反之亦然。通常情況下，方法的調用是和數據類(lèi)型有關(guān)的，但是內部函數通常在很多類(lèi)型上都可以使用。舉個(gè)例子來(lái)說(shuō)，列表的reverse方法僅僅對列表有用，但是len函數對任何具有長(cháng)度的對象都適用。

　　16. 不能直接改變不可變數據類(lèi)型

　　記住你沒(méi)法直接的改變一個(gè)不可變的對象(例如，元組，字符串)：

　　T = (1, 2, 3)

　　T[2] = 4 # 錯誤

　　用切片，聯(lián)接等構建一個(gè)新的對象，并根據需求將原來(lái)變量的值賦給它。因為Python會(huì )自動(dòng)回收沒(méi)有用的內存，因此這沒(méi)有看起來(lái)那么浪費：

　　T = T[:2] + (4,) # 沒(méi)問(wèn)題了: T 變成了 (1, 2, 4)

　　17. 使用簡(jiǎn)單的for循環(huán)而不是while或者range

　　當你要從左到右遍歷一個(gè)有序的對象的所有元素時(shí)，用簡(jiǎn)單的for循環(huán)(例如，for x in seq:)相比于基于while-或者range-的計數循環(huán)而言會(huì )更容易寫(xiě)，通常運行起來(lái)也更快。

　　除非你一定需要，盡量避免在一個(gè)for循環(huán)里使用range：讓Python來(lái)替你解決標號的問(wèn)題。在下面的例子中三個(gè)循環(huán)結構都沒(méi)有問(wèn)題，但是第一個(gè)通常來(lái)說(shuō)更好;在Python里，簡(jiǎn)單至上。

　　S = "lumberjack"

　　for c in S: print c # 最簡(jiǎn)單

　　for i in range(len(S)): print S[i] # 太多了

　　i = 0 # 太多了

　　while i < len(S): print S[i]; i += 1