在 python 中，__name__ 是一個內(nèi)置變量，用于標(biāo)識當(dāng)前模塊的名字。當(dāng)模塊被直接運行時，其 __name__ 值為 ‘__main__’，而被導(dǎo)入時則為模塊名；1. 利用 if __name__ == ‘__main__’: 可控制代碼僅在直接運行時執(zhí)行，避免導(dǎo)入時觸發(fā)副作用；2. 此機(jī)制適用于分離測試與功能代碼、提供模塊自檢或示例代碼、防止重復(fù)初始化資源、控制插件系統(tǒng)行為等場景，有助于提升代碼的可維護(hù)性和結(jié)構(gòu)清晰度。
在 python 中，__name__ 是一個內(nèi)置的特殊變量，它用來標(biāo)識當(dāng)前模塊的名字。理解它的作用，尤其是在模塊被導(dǎo)入時的行為，是寫出結(jié)構(gòu)清晰、可復(fù)用代碼的重要基礎(chǔ)。
__name__ 的基本含義
每個 Python 模塊都有一個 __name__ 屬性。當(dāng)你運行一個腳本的時候，Python 解釋器會自動為這個腳本設(shè)置 __name__ = ‘__main__’。而如果這個模塊是被其他模塊導(dǎo)入的，那么它的 __name__ 就會被設(shè)為模塊的實際名稱。
比如你有一個文件叫 my_module.py，如果你直接運行它，那里面的 print(__name__) 會輸出 ‘__main__’；但如果你從另一個文件中導(dǎo)入它，比如 import my_module，這時候 my_module 里的 __name__ 就是 ‘my_module’。
利用 if __name__ == ‘__main__’: 控制執(zhí)行邏輯
這是最常見也最有用的使用方式。通過判斷 __name__ 的值，你可以決定哪些代碼只在模塊被直接運行時才執(zhí)行，而在模塊被導(dǎo)入時不執(zhí)行。
立即學(xué)習(xí)“Python免費學(xué)習(xí)筆記（深入）”；
舉個例子：
# my_script.py def main(): print("程序主邏輯") if __name__ == '__main__': main()
這樣寫的好處有：
- 保證模塊可以作為獨立腳本運行
- 同時也能被安全地導(dǎo)入到別的模塊中而不觸發(fā)不必要的副作用
這種寫法特別適合寫命令行工具或測試代碼。很多初學(xué)者忽略這一點，導(dǎo)致在導(dǎo)入模塊時意外執(zhí)行了測試代碼或啟動邏輯。
模塊導(dǎo)入時 __name__ 的行為變化
當(dāng)一個模塊被導(dǎo)入時，它的 __name__ 會被設(shè)為模塊路徑。例如：
- 導(dǎo)入 utils.py，則 __name__ 是 ‘utils’
- 如果模塊位于包中，比如 package/utils.py，那 __name__ 會是 ‘package.utils’
這也意味著，你可以在模塊內(nèi)部根據(jù)其加載方式做一些不同的處理。比如打印日志時帶上模塊名，或者根據(jù)不同調(diào)用方式啟用不同的配置。
實際開發(fā)中的幾個常見用途
- 分離測試與功能代碼：把測試代碼放在 if __name__ == ‘__main__’: 塊里，避免導(dǎo)入時運行。
- 模塊自檢或示例代碼：提供一些簡單的使用樣例，方便調(diào)試和文檔展示。
- 防止重復(fù)執(zhí)行初始化邏輯：有些資源（如數(shù)據(jù)庫連接）只需要初始化一次，用 __name__ 可以幫助判斷是否已經(jīng)加載過。
- 控制插件系統(tǒng)行為：某些框架會利用模塊的 __name__ 來識別插件來源或注冊路徑。
基本上就這些。雖然 __name__ 看起來是個小細(xì)節(jié)，但在組織模塊結(jié)構(gòu)、避免副作用、提高可維護(hù)性方面，它其實很關(guān)鍵。不復(fù)雜但容易忽略。
.png)
