Visual Studio Code已指向虚拟环境为何仍用全局Python配置?
问题原因与解决方案
核心逻辑
pkg_resources查询依赖版本的结果完全跟随实际运行代码的Python解释器,返回全局版本说明Notebook启动时实际调用的解释器不是你选中的虚拟环境解释器,而是全局环境的Python。
高频诱因
- Notebook内核未绑定对应虚拟环境
VSCode的Jupyter Notebook内核是独立配置项,不会完全同步工作区解释器的选择设置。多数情况下你仅在全局解释器选择界面指定了venv路径,但没有单独在Notebook右上角的内核选择栏指定对应venv内核,导致Notebook默认调用了预先注册的全局Python内核运行代码。
可执行以下代码验证:
若输出路径不是import sys print(sys.executable)~/Desktop/workspace/venv/bin/python,即可确认是该问题。 - Jupyter扩展内核缓存异常
即使之前已经给Notebook选中过该venv的内核,VSCode的Jupyter扩展偶尔会出现内核元数据缓存失效:内核列表显示的是venv路径,但实际启动进程时调用了缓存里的全局Python路径。 - 极低概率场景:venv路径配置异常
若venv创建时配置损坏,导致全局环境的site-packages被优先加载到sys.path,也可能出现版本查询错误。但该问题一般会在终端直接运行venv的Python时复现,和你当前终端执行pip list结果正常的表现不匹配,因此出现概率极低。
解决步骤
- 点击Notebook右上角的内核选择按钮,手动从列表中选中
~/Desktop/workspace/venv/bin/python对应的内核,不要使用默认全局内核。 - 若内核列表中找不到对应venv选项,可打开VSCode命令面板,执行
Jupyter: Select Interpreter to Start Jupyter Server,指定venv的Python路径后重新加载窗口,再重新选择Notebook内核。 - 选中内核后,再次执行上述
sys.executable代码确认输出路径为venv下的Python,再重新查询OpenCV版本即可。
内容的提问来源于stack exchange,提问作者bpops
相关产品推荐
相关产品推荐

