VS Code中Jupyter内核可检测但无法自动选择的问题排查

以下是几个可尝试的解决方案：

• 配置工作区/全局默认内核
  打开VS Code设置界面（快捷键Ctrl+,），分别搜索并设置：

  • Python: Default Interpreter Path：选择你想要默认的Python 3.11安装路径
  • Jupyter: Default Kernel：直接选中"Python 3.11"作为默认内核
    如果是针对特定工作区，点击设置界面右上角的"工作区"标签保存配置，该工作区下的所有Notebook都会优先使用指定内核。

• 给单个Notebook绑定内核元数据
  打开目标.ipynb文件，打开命令面板（Ctrl+Shift+P），输入Notebook: 以JSON格式打开，在文件的metadata字段中添加内核指定信息，示例如下：

  "metadata": {
    "kernelspec": {
      "display_name": "Python 3.11",
      "language": "python",
      "name": "python3"
    }
  }
  

  保存后，下次打开这个Notebook就会自动加载指定内核。若有多个Notebook需要设置，可写简单Python脚本批量修改元数据。

• 清理冗余的内核注册
  打开终端，执行jupyter kernelspec list查看当前所有注册的Jupyter内核，找到你不需要的mingw64下的Python 3.10内核，用jupyter kernelspec remove <内核名称>命令删除它（替换<内核名称>为实际内核标识）。减少可选内核后，VS Code的自动匹配逻辑更容易定位到常用的Python 3.11。

• 重新注册目标内核并更新依赖
  激活Python 3.11环境，依次执行以下命令：

  pip install ipykernel --upgrade
  python -m ipykernel install --user --name python3.11 --display-name "Python 3.11"
  

  确保目标环境的ipykernel为最新版本，且注册的内核信息更明确，提升VS Code自动匹配的优先级。

• 调整内核选择策略
  在VS Code设置中搜索Jupyter: Kernel Selection，检查以下选项：

  • 关闭Jupyter: Kernel Selection Ignore Venv，确保工作区的虚拟环境（若使用）被优先检测
  • 配置Jupyter: Preferred Kernels，添加规则，比如指定某个目录下的Notebook自动匹配Python 3.11内核，示例规则：

    "jupyter.preferredKernels": {
      "**/*.ipynb": {
        "python": "python3.11"
      }
    }
    

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