Windows系统VS Code中Jupyter Notebook遇ModuleNotFoundError但.py文件正常的解决方法

核心原因 #

你的Jupyter Notebook使用的Python解释器环境，和普通.py文件运行时的环境不一致——包安装在了后者的环境里，前者找不到。

解决步骤 #

1. 确认正常运行的Python环境路径 #

在能正常执行的.py文件中添加以下代码并运行：

import sys
print(sys.executable)

会得到类似这样的路径：C:\Users\你的用户名\AppData\Local\Programs\Python\Python310\python.exe，复制这个路径。

2. 切换Jupyter的内核到对应环境 #

• 打开你的Jupyter Notebook，点击右上角显示的当前内核名称（比如Python 3.9.6 64-bit）
• 选择Select Another Kernel选项
• 在弹出的列表里找到和刚才复制的路径对应的Python环境，选中它即可

3. 若找不到对应环境，手动给Jupyter环境安装包 #

打开VS Code的终端，输入以下命令（把路径替换成你刚才复制的）：

C:\Users\你的用户名\AppData\Local\Programs\Python\Python310\python.exe -m pip install pandas matplotlib numpy

这会直接把需要的包安装到Jupyter当前使用的环境里。

4. 虚拟环境用户额外操作 #

如果你用了虚拟环境（比如venv），先激活虚拟环境：

venv\Scripts\activate

然后安装Jupyter内核到虚拟环境：

ipython kernel install --user --name=自定义内核名称

之后回到Jupyter Notebook，选择这个自定义名称的内核即可。

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