如何将单文件模块中导入的第三方模块/方法设为私有？

你提到的用下划线开头重命名导入的第三方模块/方法，完全可行，这也是Python社区里常用的“内部约定”做法。下面详细拆解这个方案，再给你几个更彻底的替代方案：

一、下划线重命名方案：简单且符合约定 #

Python里，以下划线_开头的变量、模块导入名，被视为内部实现细节——虽然语法上没有强制禁止外部访问，但所有Python开发者都会默认不去碰这类名字。

举个你的示例DemoModule.py：

# DemoModule.py
# 把numpy重命名为内部用的_numpy
import numpy as _numpy

def process_data(data):
    return _numpy.array(data)

当外部导入这个模块时：

import DemoModule
# 虽然技术上能拿到，但没人会这么做，也不符合规范
DemoModule._numpy  # 不推荐外部访问
# 正常只会用模块暴露的公开接口
DemoModule.process_data([1,2,3])

这个方案的优点是简单直观，不需要额外代码，完全靠社区约定约束，足够应对绝大多数场景。

二、其他更彻底的方案 #

如果你需要更严格的隐藏（比如防止外部误访问），可以试试下面这些方法：

1. 用__all__明确指定公开接口 #

__all__是模块级别的变量，用来定义当外部执行from DemoModule import *时，哪些名字会被导入。只要不把第三方模块/方法放进__all__，就能避免它们被批量导入。

示例：

# DemoModule.py
import numpy

# 只公开我们自己的函数
__all__ = ['process_data']

def process_data(data):
    return numpy.array(data)

效果：

from DemoModule import *
process_data([1,2,3])  # 正常可用
numpy  # 报错：NameError: name 'numpy' is not defined

# 但注意：直接导入模块还是能拿到，只是*导入不行
import DemoModule
DemoModule.numpy  # 依然能访问到

可以把这个方案和下划线重命名结合，双重保障：

import numpy as _numpy
__all__ = ['process_data']

def process_data(data):
    return _numpy.array(data)

2. 将导入放在函数内部（按需导入） #

如果第三方模块只在某个特定函数里用到，完全可以把import语句移到函数内部。这样模块层面根本不会存在这个第三方模块的变量，外部自然无法访问。

示例：

# DemoModule.py
def process_data(data):
    # 只在需要的时候导入numpy
    import numpy
    return numpy.array(data)

这个方案的好处是：不仅隐藏了导入，还能延迟加载第三方模块（只有调用函数时才会导入），适合那些不常用的依赖。缺点是如果多个函数都需要用同一个第三方模块，会重复写import语句，但Python会缓存模块，重复import不会重复加载，性能不受影响。

3. 用__dir__和__getattr__控制属性访问 #

如果想要彻底隐藏，连直接import DemoModule都看不到第三方模块的名字，可以通过自定义__dir__和__getattr__来实现：

# DemoModule.py
import numpy as _numpy

def process_data(data):
    return _numpy.array(data)

def __dir__():
    # 自定义模块的dir()结果，只返回公开名字
    return ['process_data']

def __getattr__(name):
    # 当外部访问不存在的名字时，抛出错误
    raise AttributeError(f"module 'DemoModule' has no attribute '{name}'")

效果：

import DemoModule
dir(DemoModule)  # 输出 ['process_data']
DemoModule._numpy  # 报错：AttributeError
DemoModule.numpy  # 报错：AttributeError

这个方案最彻底，但需要额外写一点代码，适合对模块封装性要求极高的场景。

总结 #

• 下划线重命名：最简单、最符合Python约定，推荐作为首选方案。
• __all__：适合配合*导入场景，明确公开接口边界。
• 函数内导入：适合依赖只在局部使用的场景，还能实现延迟加载。
• 自定义__dir__/__getattr__：最彻底的隐藏方案，适合高封装需求的场景。

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