VS Code中Jupyter Notebook调用虚拟环境失败，提示需安装ipykernel

1. 确认虚拟环境内核已注册到Jupyter #

即便虚拟环境中安装了ipykernel，仍需手动将其注册为Jupyter的可用内核，否则VS Code无法识别关联：

• 激活虚拟环境：在VS Code终端执行

  proj_env\Scripts\activate.bat
  

• 注册内核：激活后运行

  python -m ipykernel install --user --name=proj_env --display-name="Python (proj_env)"
  

  其中proj_env为你的虚拟环境名称，可自定义。注册完成后重启VS Code，在Notebook的内核选择器中选中这个新注册的内核。

2. 修正settings.json中的路径格式 #

Windows系统下，JSON文件中的路径需使用双反斜杠或正斜杠，单斜杠会被识别为转义字符导致路径失效：

• 错误写法："proj_env\Scripts\python.exe"
• 正确写法："proj_env\\Scripts\\python.exe" 或 "proj_env/Scripts/python.exe"
  修改后保存settings.json，重启VS Code。

3. 清除VS Code Jupyter扩展缓存 #

扩展缓存可能导致内核信息未更新：

• 关闭VS Code
• 删除以下路径的缓存文件夹（替换为你的用户名）：

  C:\Users\<你的用户名>\AppData\Roaming\Code\CachedData
  C:\Users\<你的用户名>\AppData\Roaming\Code\User\workspaceStorage
  

• 重新打开VS Code，加载项目后重新选择虚拟环境解释器。

4. 验证终端环境与解释器一致性 #

• 打开VS Code终端，输入where python，确认输出的第一个路径是虚拟环境的proj_env\Scripts\python.exe
• 若路径不符，可在项目的.vscode/settings.json中添加配置，强制终端激活虚拟环境：

  "terminal.integrated.defaultProfile.windows": "Command Prompt",
  "python.terminal.activateEnvironment": true
  

5. 重新安装ipykernel并关联 #

若以上步骤无效，尝试在虚拟环境中重装ipykernel：

• 激活虚拟环境后执行：

  pip uninstall -y ipykernel
  pip install ipykernel==6.17.0
  

  之后再次执行内核注册命令，重启VS Code。

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