如何让Jupyter Notebook子模块识别全局定义的变量？

问题原因 #

导入y.py时，Python会立即执行模块内的代码，此时y.py的命名空间中不存在变量z，而Jupyter Notebook的全局变量z不会自动共享到子模块的命名空间，因此触发NameError。

可行解决方案 #

方案1：将计算逻辑封装为函数（推荐）

把y.py中的直接变量赋值改为接收参数的函数，避免依赖外部全局变量：

# y.py
def get_y(z):
    return 2 * z

在main.ipynb中调用：

z = 15
import y
print(y.get_y(z))  # 输出30

这种方式模块化程度高，代码更易维护，也符合Python的最佳实践。

方案2：导入前将z注入y模块的命名空间

如果必须使用全局变量的方式，可以在导入y前，把z添加到y模块的字典中：

# main.ipynb 单元格
z = 15
import sys
# 先将z注入y模块的命名空间
sys.modules['y'].__dict__['z'] = z
import y
print(y.y)  # 输出30

注意：这种方式耦合性极强，仅适合临时测试，不建议用于正式代码。

方案3：从主模块导入z

在y.py中直接从主模块（Jupyter Notebook的主环境）导入z：

# y.py
from __main__ import z
y = 2 * z

在main.ipynb中需先定义z再导入y：

z = 15
import y
print(y.y)  # 输出30

这种方式依赖主环境的变量定义顺序，灵活性较差，一旦主环境未定义z就会报错。

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