Mac系统下VS Code无法识别手动创建的Python虚拟环境内核

以下是针对该问题的具体排查和解决步骤：

• 确认VS Code选中目标虚拟环境的解释器
  打开VS Code，按下Cmd+Shift+P调出命令面板，输入Python: Select Interpreter，在列表中找到~/.virtuaenvs/new_venv/bin/python并选中，之后重启Jupyter内核尝试选择。

• 手动刷新Jupyter内核列表
  在Jupyter笔记本的内核选择菜单中，点击「Refresh Kernels」（刷新内核）选项，强制VS Code检测新添加的内核。

• 确保ipykernel安装在虚拟环境内
  激活虚拟环境后，执行which ipykernel，确认输出路径是~/.virtuaenvs/new_venv/bin/ipykernel。如果指向全局Python路径，重新安装：

  source ~/.virtuaenvs/new_venv/bin/activate
  pip uninstall ipykernel jupyter -y
  pip install ipykernel jupyter
  python -m ipykernel install --name "new_venv" --user
  

• 检查内核配置文件的正确性
  执行jupyter kernelspec list，查看输出中是否存在new_venv条目。如果存在，打开对应的配置文件~/Library/Jupyter/kernels/new_venv/kernel.json，确认argv中的Python路径指向虚拟环境的Python可执行文件，示例如下：

  {
    "argv": [
      "/Users/你的用户名/.virtuaenvs/new_venv/bin/python",
      "-m",
      "ipykernel_launcher",
      "-f",
      "{connection_file}"
    ],
    "display_name": "new_venv",
    "language": "python"
  }
  

  若路径错误，手动修改后保存，重启VS Code。

• 重置Jupyter服务状态
  按下Cmd+Shift+P，输入Jupyter: Reset Jupyter Server，执行后重新打开笔记本选择内核。

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