VSCode中无法运行.ipynb文件：Python 3.11.1 Kernel不可用

API 探路者

2026-8-1

问题描述

我是VSCode新手，无法在VSCode中运行.ipynb（Jupyter Notebook）文件，Python版本为3.11.1。点击输出标签后显示以下错误：

'Kernel Python 3.11.1 is not usable'
#---------------------------------------------------#
error 13:21:58.722: Error in execution (get message for cell) [kp [Error]: Kernel Python 3.11.1 is not usable. Check the Jupyter output t
    at Um.waitForIdleOnSession (/Users/nipuni/.vscode/extensions/ms-toolsai.jupyter-2023.1.2010391206/out/extension.node.js:17:131848)
    at process.processTicksAndRejections (node:internal/process/task_queues:96:5)
    at async Um.createNewKernelSession (/Users/nipuni/.vscode/extensions/ms-toolsai.jupyter-2023.1.2010391206/out/extension.node.js:17:2750
    at async Um.connect (/Users/nipuni/.vscode/extensions/ms-toolsai.jupyter-2023.1.2010391206/out/extension.node.js:17:273916)
    at async Km.startNew (/Users/nipuni/.vscode/extensions/ms-toolsai.jupyter-2023.1.2010391206/out/extension.node.js:17:281707)
    at async a (/Users/nipuni/.vscode/extensions/ms-toolsai.jupyter-2023.1.2010391206/out/extension.node.js:17:245682)
    at async lm.createNotebookInstance (/Users/nipuni/.vscode/extensions/ms-toolsai.jupyter-2023.1.2010391206/out/extension.node.js:17:2458
    at async lm.createNotebook (/Users/nipuni/.vscode/extensions/ms-toolsai.jupyter-2023.1.2010391206/out/extension.node.js:17:246529)
    at async Zm.createJupyterSession (/Users/nipuni/.vscode/extensions/ms-toolsai.jupyter-2023.1.2010391206/out/extension.node.js:17:306419
  category: 'invalidkernel',
  kernelConnectionMetadata: Zd {
    kind: 'startUsingPythonInterpreter',
    kernelSpec: id {
      specFile: undefined,
      interpreterPath: '/usr/local/bin/python3',
      isRegisteredByVSC: 'registeredByNewVersionOfExt',
      name: 'pythonjvsc74a57bd0aee8b7b246df8f9039afb4144a1f6fd8d2ca17a180786b69acc140d282b71a49',
      argv: [Array],
      language: 'python',
      executable: 'python',
      display_name: 'Python 3',
      metadata: [Object],
      env: {},
      interrupt_mode: undefined
    },
    interpreter: {
      id: '/usr/local/bin/python3',
      sysPrefix: '/Library/Frameworks/Python.framework/Versions/3.11',
      envPath: undefined,
      displayPath: [f],
      envName: '',
      uri: [f],
      displayName: '',
      envType: 'Unknown',
      version: [Object]
    },
    id: '.jvsc74a57bd0aee8b7b246df8f9039afb4144a1f6fd8d2ca17a180786b69acc140d282b71a49./usr/local/bin/python3./usr/local/bin/python3.-m#i
  },
  vslsStack: [
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}, CallSite {},
    CallSite {}
  ]
}
[W 13:22:38.510 NotebookApp] Timeout waiting for kernel_info reply from 204ac218-8e43-4f52-a647-55804cd1ed98
[E 13:22:38.516 NotebookApp] Error opening stream: HTTP 404: Not Found (Kernel does not exist: 204ac218-8e43-4f52-a647-55804cd1ed98)

解决方案

安装/修复Jupyter依赖
打开终端，执行以下命令确保Python环境里装了Jupyter和内核相关包：
```
pip3 install --upgrade jupyter ipykernel
```
手动注册Python内核
把你的3.11.1环境手动注册到Jupyter：
```
python3 -m ipykernel install --user --name=python3.11.1
```
刷新VSCode内核列表
在.ipynb文件右上角点击内核选择器（显示"Python 3"的地方），选择"刷新内核列表"，然后选刚注册的python3.11.1内核。
更新Jupyter扩展
打开VSCode扩展面板，找到"Jupyter"扩展，检查更新并安装最新版，之后重启VSCode。
确认Python解释器路径
按下Cmd+Shift+P（Mac）或Ctrl+Shift+P（Windows），输入"Python: Select Interpreter"，确认选的是/usr/local/bin/python3（对应你的3.11.1版本）。
清理旧内核配置（可选）
如果以上步骤无效，终端里执行cd ~/Library/Jupyter/kernels进入内核配置目录，删除可疑的旧内核文件夹，再重新注册内核。

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