Python模块如何限制内部未开放函数/类被外部导入调用

Python 本身遵循「约定优于强制」的设计哲学，没有原生的严格私有成员限制，所有方案都属于软限制，但足够满足绝大多数工程场景下的防误调用需求：

1. 社区通用命名约定（成本最低，推荐首选） #

给所有不对外暴露的成员加单下划线_前缀：

__all__ = ["some_func"]

def some_func():
    pass

# 单下划线前缀标识为内部成员
def _internal_use_only():
    # some dangerous operations

• 这是Python社区通用的约定，所有主流IDE、静态检查工具都会对直接调用单下划线成员的操作给出警告，自动文档生成工具也会默认忽略这类成员。
• 虽依然可以被强行调用，但已经可以拦住99%的非故意访问场景。

2. 模块级__getattr__拦截访问（3.7+版本支持，限制更强） #

Python 3.7及以上版本支持自定义模块的__getattr__方法，对外部访问模块属性的行为做拦截，未公开的成员直接抛出属性不存在的错误：

__all__ = ["some_func"]

def some_func():
    pass

def internal_use_only():
    # some dangerous operations

# 自定义属性访问拦截
def __getattr__(name):
    if name in ("internal_use_only",):
        raise AttributeError(f"module '{__name__}' has no attribute '{name}'")
    raise AttributeError(f"module '{__name__}' has no attribute '{name}'")

# 可选：自定义__dir__隐藏内部成员，让dir()调用时看不到内部函数
def __dir__():
    return __all__

配置完成后，外部调用above_module.internal_use_only()会直接抛出AttributeError，和真实不存在的属性表现完全一致。

3. 封装到局部作用域（完全无法从外部直接访问） #

如果需要完全杜绝外部直接访问，可以把内部函数放到公开函数的嵌套作用域，或者封装到类的私有方法中：

__all__ = ["some_func"]

def some_func():
    # 内部函数仅在some_func作用域内可访问
    def internal_use_only():
        # some dangerous operations
    internal_use_only()

这种方式下internal_use_only完全属于some_func的局部成员，外部没有任何直接访问的入口。

注意：以上所有方案都只是软限制，如果用户刻意要访问内部成员，依然可以通过直接读取模块__dict__等方式拿到，本质是Python的设计理念决定的，工程场景下不需要做过度的防破解设计，上述方案已经足够。

内容的提问来源于stack exchange，提问作者TFC