python實(shí)現(xiàn)控制模塊可以導(dǎo)出的內(nèi)容
更新時(shí)間：2025年09月12日 08:54:45 作者：無風(fēng)聽海
Python模塊通過__all__列表控制import*導(dǎo)出內(nèi)容,使用_前綴隱藏內(nèi)部函數(shù),__magic__為特殊符號,推薦明確API并合理使用命名空間
在 Python 中，我們可以通過在模塊中定義 __all__ 列表，控制該模塊通過 from module import * 導(dǎo)出的內(nèi)容。
1. 使用__all__控制導(dǎo)出
# 文件：my_module.py
__all__ = ['func1', 'MyClass'] # 只允許導(dǎo)出這些
def func1():
pass
def func2():
pass # 不會被 * 導(dǎo)入
class MyClass:
pass
然后在其他地方：
from my_module import * func1() # ? 可以使用 MyClass() # ? 可以使用 func2() # ? NameError: name 'func2' is not defined
說明：
__all__是一個(gè)字符串列表，定義了從這個(gè)模塊使用from xxx import *時(shí)，能導(dǎo)入的名稱。- 對
import my_module和from my_module import func2沒有影響，它們?nèi)匀豢梢栽L問不在__all__中的成員。
2. 手動控制命名空間
如果你不想別人通過 from my_module import * 看到你內(nèi)部函數(shù)，可以：
def _internal_helper():
# 這是內(nèi)部函數(shù)，不打算對外暴露
...
def public_func():
...
在 Python 中，以單下劃線開頭的變量或函數(shù)名（如 _internal_helper）默認(rèn)不會被 import * 導(dǎo)入。
3. 私有 vs 公有符號建議
| 名稱形式 | 是否默認(rèn)導(dǎo)出（被 * 看到） | 用途建議 |
|---|---|---|
| func1 | ? 是 | 公共 API |
| _helper_func | ? 否 | 模塊內(nèi)部工具函數(shù) |
| __magic__ | ? Python 保留 | 特殊用途 |
| __all__ | ? 手動控制 | 導(dǎo)出白名單 |
示例：更完整的模塊設(shè)計(jì)
# mymath.py
__all__ = ['add', 'multiply']
def add(x, y):
return x + y
def multiply(x, y):
return x * y
def _debug_log(x):
print(f"Debug: {x}")
用戶代碼：
from mymath import * add(2, 3) # ? multiply(2, 3) # ? _debug_log(1) # ? NameError
總結(jié)
| 控制方式 | 效果 | 推薦使用場景 |
|---|---|---|
| __all__ = [...] | 限制 import * 能導(dǎo)出的內(nèi)容 | 公開 API 明確時(shí) |
| 前綴 _ | 默認(rèn)隱藏，不導(dǎo)出 | 工具函數(shù)、私有變量 |
| import xxx | 無限制，訪問完整模塊命名空間 | 推薦日常用法 |
以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。
相關(guān)文章
文章介紹了在Python中讀取Excel文件的兩種方法：使用pandas庫和使用openpyxl庫,pandas適合數(shù)據(jù)分析和處理,而openpyxl提供了更多的Excel文件操作功能,感興趣的朋友跟隨小編一起看看吧2024-11-11
Appium自動化測試實(shí)現(xiàn)H5頁面元素定位
本文主要介紹了Appium自動化測試實(shí)現(xiàn)H5頁面元素定位，文中通過示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下2022-02-02
隨著現(xiàn)代計(jì)算機(jī)性能的提高和網(wǎng)絡(luò)速度的加快,越來越多的用戶需要對他們的屏幕進(jìn)行錄制,這篇文章主要介紹了Python屏幕抓取和錄制的相關(guān)資料,需要的朋友可以參考下2025-09-09
這篇文章主要介紹了用python給自己做一款小說閱讀器過程詳解,文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2019-07-07
Python實(shí)現(xiàn)提取給定網(wǎng)頁內(nèi)的所有鏈接
這篇文章主要和大家分享一個(gè)實(shí)用的Python腳本，可以實(shí)現(xiàn)從給定的網(wǎng)頁中檢索所有鏈接，并將其保存為txt文件，需要的小伙伴可以收藏一下2023-05-05
今天小編就為大家分享一篇Python 之 Json序列化嵌套類方式，具有很好的參考價(jià)值，希望對大家有所幫助。一起跟隨小編過來看看吧2020-02-02
這篇文章主要介紹了Python抽象類應(yīng)用詳情，抽象類就是控制子類的方法的名稱，要求子類必須按照父類的要求的實(shí)現(xiàn)指定的方法，且方法名要和父類保持一致，下文更多相關(guān)介紹需要的小伙伴可以參考一下2022-04-04
在pytorch中計(jì)算準(zhǔn)確率,召回率和F1值的操作
這篇文章主要介紹了在pytorch中計(jì)算準(zhǔn)確率,召回率和F1值的操作，具有很好的參考價(jià)值，希望對大家有所幫助。如有錯(cuò)誤或未考慮完全的地方，望不吝賜教2021-05-05
這篇文章主要為大家詳細(xì)介紹了如何使用Python編寫一個(gè)自動詩歌生成器,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2026-05-05
pytorch實(shí)現(xiàn)特殊的Module--Sqeuential三種寫法
今天小編就為大家分享一篇pytorch實(shí)現(xiàn)特殊的Module--Sqeuential三種寫法。具有很好的參考價(jià)值，希望對大家有所幫助。一起跟隨小編過來看看吧2020-01-01