寫 Python 腳本時,一定要加上這個

我發現有不少朋友寫 Python 腳本非常隨意,要么不用函數,要么函數隨處定義,反正第一眼看不出要執行的第一行代碼位于何處,這樣的腳本可讀性很差,而且容易隱藏 bug,解決這個問題很簡單,當我們寫 Python 腳本時,一定要加上這個:

def main():
    # do something
    print("do something.")


if __name__ == "__main__":
    main()

你可能要反對了:我怎么爽就怎么寫,憑什么聽你的,多寫個 if name...?

別急,讓我說三個原因。

第一,它讓 Python 文件的作用更加明確

首先需要明白 name 的作用,當腳本直接被 Python 解釋器執行時,其值就是 "main",當其被其他 Python 程序 import 的時候,其值就是對應的 Python 腳本文件名,可以在 Python 解釋器驗證下,假定有個 some_script.py 其內容如下:

print("some_script.py")
print(__name__)

在 Python 解釋器導入一下:

? vim some_script.py
? python
Python 3.8.5 (v3.8.5:580fbb018f, Jul 20 2020, 12:11:27)
[Clang 6.0 (clang-600.0.57)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import some_script
some_script.py
some_script
>>>

可以看到,name 的值就是 Python 腳本的文件名 some_script。

也就是說 if name == "main": 后面的代碼在 import 的時候是不會運行的。

明白了這一點,if name == "main": 就可以做為區分腳本和庫的一個標志,當我們看到 if name == "main": 時,就認為這一個可以直接運行的腳本,當沒有看到這行代碼時,就認為這是一個庫,可以被其他程序引用,Explicit is better than implicit.,不是嗎?

再舉個例子:

假如你寫了一個不帶if name == "main": 的腳本,叫 bad_script.py,內容如下:

def useful_function(x):
    return x * x


class UsefulClass:
    def __init__(self, x):
        self.x = x

#你自己測試了一吧,沒毛病
for i in range(7):
    print(useful_function(i))
    

別人寫了個 useful.py,引用了你的 useful_function:

from bad_script import useful_function


def main():
    print(f'{useful_function(3)=}')


if __name__ == '__main__':
    main()
    

一運行,發現打印了不可預期的內容,見下圖紅色部分:

image.png

查了半天原因,發現是你的腳本輸出的,你說別人會不會罵你?

假如你在自己腳本里定義了全局變量,別人如果在不合適的位置導入了 *,就會把你這個全局變量也導入,導致變量覆蓋,很容易會出現 bug。

第二,它讓 Python 文件更加易讀,對 IDE 友好

有了 if name == "main": 相當于 Python 程序也有了一個入口函數,所有的變量都從這里開始定義和使用,我們可以清晰的知道程序的邏輯開始于何處(當然還需要我們自覺的把程序的開始邏輯都放在這里)

其實,這也是 PyCharm 推薦的做法,當你新建一個項目的時候,它默認創建的 main.py 就是長這樣的:


image.png

在if name == "main": 的那一行的最左邊也有一個綠色的運行按鈕,點擊一下,程序就從這一行開始運行了。

為什么很多優秀的編程語言,比如 C、Java、Golang、C++ 都有一個 main 入口函數呢?我想很重要的一個原因就是就是程序入口統一,容易閱讀。

第三、多進程場景下,必須用 if main

比如說你用多進程搞并行計算,寫了這樣的代碼:

import multiprocessing as mp


def useful_function(x):
    return x * x

print("processing in parallel")
with mp.Pool() as p:
    results = p.map(useful_function, [1, 2, 3, 4])
    print(results)

當你運行的時候,會發現程序不停的在創建進程,同時也在不停的報錯 RuntimeError,即使你 Ctrl C 也無法終止程序。而加上了 if name == "main": 程序就會按照預期的進行:

import multiprocessing as mp


def useful_function(x):
    return x * x

if __name__ == '__main__':
    print("processing in parallel")
    with mp.Pool() as p:
        results = p.map(useful_function, [1, 2, 3, 4])
        print(results)

這是為什么呢?

其實我是這樣理解的,Python 的多程序就是啟動了多個 Python 解釋器,每個 Python 解釋器都會導入你這個腳本,復制一份全局變量和函數給子進程用,如果有了if name == "main":,那它后面的代碼就不會被 import,也就不會被重復執行。否則,這個創建多進程的代碼就會被 import,就會被執行,從而無限遞歸的去創建子進程,Python3 會報 RuntimeError,順序是先創建進程,然后報錯的,因此就會出現不停的創建進程,不停的報錯,Ctrl C 也無法終止的現象,只能 kill 掉整個終端。這里有個官方解釋

最后的話

if name == "main": 雖然不是強制的,但是基于上述三點原因,我強烈推薦你這么做,它是 Python 社區的約定,對應Python 之禪:明確優于隱晦。正如 _ 作為變量名的意思就是告訴讀代碼的人:這個變量不重要,后面也不會用到它。當你看到 Python 腳本有 if name == "main": 時,就會意識到,這是一個可執行的腳本,當被其他程序導入時,這部分代碼不會被執行,而多進程的程序中,這是必須的。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,546評論 6 533
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,570評論 3 418
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,505評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,017評論 1 313
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,786評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,219評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,287評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,438評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,971評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,796評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,995評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,540評論 5 359
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,230評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,662評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,918評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,697評論 3 392
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,991評論 2 374

推薦閱讀更多精彩內容