VS Code更新Python/Jupyter扩展后虚拟环境依赖异常求助

排查与修复步骤 #

1. 手动指定Jupyter可执行文件路径 #

打开VS Code设置（快捷键Ctrl+,），搜索jupyter.executablePath，选择编辑 in settings.json，添加你的conda虚拟环境中Jupyter的绝对路径：

• Windows示例：

"jupyter.executablePath": "C:/Users/xxx/miniconda3/envs/your_env/Scripts/jupyter.exe"

• Linux/macOS示例：

"jupyter.executablePath": "/home/xxx/miniconda3/envs/your_env/bin/jupyter"

保存设置后重启VS Code。

2. 清除VS Code扩展缓存与残留数据 #

关闭VS Code，删除以下路径的相关文件：

• Windows：
  • %USERPROFILE%\.vscode\extensions中以ms-python.python和ms-toolsai.jupyter开头的文件夹
  • %APPDATA%\Code\Cache、%APPDATA%\Code\CachedData
• Linux：
  • ~/.vscode/extensions中对应Python、Jupyter的扩展文件夹
  • ~/.config/Code/Cache、~/.config/Code/CachedData
• macOS：
  • ~/Library/Application Support/Code/Cache、~/Library/Application Support/Code/CachedData
  • ~/.vscode/extensions中相关扩展文件夹
    重新启动VS Code，重新加载扩展。

3. 重新注册虚拟环境内核 #

激活你的conda虚拟环境，执行命令重新注册内核：

conda activate your_env
python -m ipykernel install --user --name your_env --display-name "Python (your_env)"

完成后回到VS Code，在内核选择器中选中Python (your_env)测试。

4. 回退至旧版本扩展 #

若确定是更新引发的问题，可回退Python和Jupyter扩展：

• 打开扩展面板，找到Python扩展，点击右下角齿轮图标→Install Another Version...，选择更新前的稳定版本
• 对Jupyter extension执行相同操作，重启VS Code后验证。

5. 确认Python解释器选择正确 #

• 点击VS Code左下角状态栏的Python版本号，在弹出列表中选择目标conda虚拟环境
• 或通过命令面板（Ctrl+Shift+P）执行Python: Select Interpreter，选中你的your_env环境

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