适用场景

  • 你在 CMD 里 pip install xxx 成功;

  • 但在 Jupyter Notebook 里 import xxx 报错;

  • 原因通常是:Jupyter 当前 Kernel 不是你安装包的那个 Python 环境


第 1 步:在 CMD 里确认你想使用的 Python/Pip

打开 CMD,执行:

where python where pip python -c "import sys; print(sys.executable)" pip -V

你要确认两点:

  1. python -c ... 输出的路径是你想用的 Python(例如 Python310)

  2. pip -V 显示的 (python X.Y) 与该 Python 版本一致


第 2 步:给这个 Python 安装 ipykernel

仍在 CMD 里执行:

python -m pip install -U ipykernel

说明:
ipykernel 是 Jupyter 识别并启动某个 Python 环境所需的组件。没有它,就无法把该环境作为 Kernel 供 Jupyter 选择。


第 3 步:把该 Python 注册成一个 Jupyter Kernel

在 CMD 里执行(名称可按需调整):

python -m ipykernel install --user --name py310 --display-name "Python 3.10 (py310)"

参数解释:

  • --user:只为当前用户注册(推荐,权限问题最少)

  • --name py310:Kernel 的内部标识(建议简短、唯一)

  • --display-name "...":你在 Jupyter 菜单里看到的名字


第 4 步:在 Jupyter 中切换到新 Kernel

回到 Jupyter Notebook 页面:

  • Notebook 顶部菜单:Kernel → Change Kernel

  • 选择:Python 3.10 (py310)(你在第 3 步设置的 display-name)

然后执行一次:Kernel → Restart(确保环境切换完全生效)。


第 5 步:验证 Jupyter 已经在使用正确的 Python

在 Notebook 新建一个单元格运行:

import sys print(sys.executable)

你应当看到与你在 CMD 里确认的 Python 路径一致(例如 ...\Python310\python.exe)。

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐