VSCode中Jupyter无法使用自建virtualenv虚拟环境问题求助

问题根因 #

该问题本质是你创建的Jupyter内核配置中绑定的Python解释器路径未指向你创建的virtualenv环境，导致内核实际调用的是系统全局Python，自然找不到venv中安装的依赖包。

修复步骤 #

1. 校验现有内核配置
   执行以下命令查看所有已注册的Jupyter内核：

   jupyter kernelspec list
   

   在输出中找到名为python_data_analytics的内核对应的本地目录，进入该目录打开kernel.json文件，检查argv数组第一个值的路径：

   • 如果路径指向的是系统全局Python（如/usr/bin/python3、/Library/Frameworks/Python.framework/Versions/3.x/bin/python3等非venv目录下的路径），直接将其修改为你创建的venv中Python的绝对路径即可，例如/Users/yourname/project/venv/bin/python3
   • 保存修改后重启Jupyter即可生效

2. 重建内核（修改配置无效时用）
   如果修改配置后问题依旧，直接删除错误内核后重建即可：

   • 执行删除命令：

   jupyter kernelspec remove python_data_analytics
   

   • 重新激活你的virtualenv环境，确认终端提示符前出现(venv)标识代表激活成功
   • 执行内核创建命令：

   python -m ipykernel install --user --name=python_data_analytics --display-name="Python (数据分析虚拟环境)"
   

   • 再次执行jupyter kernelspec list检查内核绑定的路径是否为venv内的Python路径

3. 清理VSCode缓存
   内核配置正确后如果VSCode还是调用错误解释器，做如下操作：

   • 关闭所有打开的Notebook文件
   • 按下快捷键Ctrl+Shift+P（Mac为Cmd+Shift+P），搜索并执行Jupyter: Clear Jupyter Kernel List Cache
   • 重启VSCode后重新打开Notebook，下拉选择你创建的内核即可

验证方法 #

在Notebook中运行以下代码，确认输出的路径为你虚拟环境内的Python路径即可：

import sys
print(sys.executable)

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