如何使Python模块中导入的模块对其他模块私有？

针对你遇到的情况——想让a.py里导入的numpy只在模块内部可用，不让外部模块b.py访问a.np，同时避免Jupyter Lab自动补全显示这个内部依赖，这里有几个实用的实现方法：

方法一：用下划线前缀标记内部导入（推荐） #

这是最符合Python编码惯例的做法，下划线开头的标识符会被视为模块内部私有成员，大部分IDE和Jupyter的补全工具都会自动过滤它们：

修改a.py的代码：

# a.py
import numpy as _np  # 下划线前缀标记为内部使用

def sqrt(x):
    return _np.sqrt(x)

这样一来，模块a的公共命名空间里只有sqrt函数，_np不会出现在a.的自动补全列表里。虽然技术上外部模块还是能强行访问a._np，但这违反了Python的私有成员约定，属于不规范的用法，也正是我们要传递的“内部仅用”的信号。

方法二：结合__all__明确公共API边界 #

如果想更清晰地定义模块对外暴露的内容，可以加上__all__变量，它会控制from a import *时导入的内容，同时也会被补全工具识别：

# a.py
__all__ = ['sqrt']  # 明确指定对外暴露的API列表

import numpy as _np

def sqrt(x):
    return _np.sqrt(x)

这个方法进一步强化了模块的API边界：既通过下划线隐藏了内部依赖，又明确告诉使用者和工具，模块对外提供的只有sqrt函数。在Jupyter Lab里输入a.按Tab，只会显示sqrt，完全不会出现_np或者其他内部成员。

方法三：将导入放在函数内部（仅适合单一函数使用场景） #

如果numpy只在sqrt这一个函数里用到，也可以把导入放在函数内部：

# a.py
def sqrt(x):
    import numpy as np  # 仅在函数内部导入
    return np.sqrt(x)

这样模块a的全局命名空间里根本不存在np这个属性，外部完全访问不到。不过这种方法的缺点是代码可读性稍差，而且如果多个函数需要用到numpy，重复写导入会显得冗余，所以只适合单一函数的场景。

为什么原来的代码会让a.np可访问？ #

当你在a.py里执行import numpy as np时，np会成为模块a的一个全局属性，所以外部模块可以通过a.np直接访问到。我们的核心思路就是要么把这个属性从模块的公共命名空间里移除，要么标记为内部私有，让工具和使用者都知道它不应该被外部访问。

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