Jupyter 调用自定义模块时为什么报 np 未定义？

2026-11-04数据阿明

如果 import numpy as np 已经在定义 detectOptimum() 的模块顶层执行成功，该方法通常可以直接使用 np，Notebook 中无须再次导入 numpy。仅凭当前片段还无法确定具体原因，可以先确认调用的方法来自哪个文件，再检查它使用的全局命名空间中是否存在 np。

为什么已经导入仍会报错

方法中的 np 会在定义该方法的模块全局命名空间中查找。@staticmethod 不会改变这一规则，也不会阻止方法访问模块级导入。

NameError: name 'np' is not defined 表示执行到相关代码时，函数找不到 np。可以从以下几个方向排查：

Jupyter 仍在使用修改文件前加载的代码。
实际导入了另一个路径下的同名模块。
真实代码中的导入位于其他函数或未执行的条件分支中，没有建立模块级的 np。

这条错误本身并不能说明 numpy 没有安装。

先检查实际调用的方法

在 Notebook 中，对当前的 Model 执行：

import inspect

method = Model.detectOptimum
module = inspect.getmodule(method)

print("定义模块：", method.__module__)
print("模块文件：", getattr(module, "__file__", None))
print("代码文件：", method.__code__.co_filename)
print("全局命名空间包含 np：", "np" in method.__globals__)

检查文件路径是否指向你修改的 Model.py，以及最后一项是否为 True。如果全局命名空间中没有 np，需要检查该文件实际执行的导入代码，以及 Notebook 当前持有的方法对象。

同时查看完整 traceback，确认最后报错的位置是否是这个方法里的 np.polyfit(...)。如果错误发生在其他函数中，应检查那个函数所在的模块。

修改文件后重新加载模块

Python 会缓存已经导入的模块。在同一个 kernel 中，再次运行 from library.Model import Model，通常不会重新执行磁盘上的模块代码。

保存 Model.py 后，可以显式重新加载模块，再重新绑定类名：

import importlib

model_module = importlib.import_module("library.Model")
model_module = importlib.reload(model_module)
Model = model_module.Model

predict_b5 = Model.detectOptimum()

最后一行沿用了原问题的无参数调用方式，前提是实际方法确实不需要参数。重新绑定 Model 可以避免继续通过原来的类引用调用旧方法。

也可以重启 kernel，再按顺序运行相关单元格。如果重启后问题消失，先前的会话状态可能参与了问题，但仍应通过文件路径检查确认加载的是预期模块。

核对文件位置和代码缩进

对于 from library.Model import Model 这个导入路径，常见的目录布局是：

root/
├── mynotebook.ipynb
└── library/
    ├── __init__.py
    └── Model.py

这个布局用于说明导入关系。原始目录示意没有明确展示 Model.py 的所属层级，需要与实际路径核对；__init__.py 适用于普通包，命名空间包则有不同规则。

原始代码片段也缺少必要缩进。如果实际文件完全如此，通常会先出现缩进相关错误。下面是一个独立示例，使用演示数据验证模块内导入和静态方法调用：

# library/Model.py
import numpy as np


class Model:
    @staticmethod
    def detectOptimum():
        # 演示数据，实际使用时替换为业务数据
        x = np.array([0.0, 1.0, 2.0])
        y = np.array([1.0, 3.0, 5.0])
        a, b = np.polyfit(x, y, deg=1)
        return a, b

Notebook 中调用：

from library.Model import Model

coefficients = Model.detectOptimum()
print(coefficients)

np.polyfit 还需要有效参数

原片段中的 np.polyfit() 没有传入参数。如果这不是省略写法，修复 np 的名称问题后，还会遇到缺少参数的 TypeError。

一次多项式拟合可以写为：

a, b = np.polyfit(x, y, deg=1)

两个返回值分别对应斜率和截距。如果使用更高次数的拟合，返回的系数数量也会增加，不能继续固定解包为两个变量。