VSCode for Jupyter: 更强大的交互式编程体验

VSCode中Jupyter内核异常的解决方法包括：一、重新绑定Python解释器；二、手动安装并注册ipykernel；三、禁用冲突扩展并重置Jupyter设置；四、清除Jupyter运行时缓存。

如果您在 VSCode 中使用 Jupyter 扩展进行交互式编程，但发现内核无法启动、单元格执行无响应或代码补全失效，则可能是由于扩展配置冲突、Python 环境未正确绑定或内核注册异常所致。以下是解决此问题的步骤：

本文运行环境：MacBook Pro，macOS Sequoia。

一、重新绑定 Python 解释器

VSCode 的 Jupyter 功能依赖于明确指定的 Python 解释器路径；若解释器未绑定或指向无效环境，内核将无法初始化。

1、按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），打开命令面板。

2、输入并选择 Python: Select Interpreter。

3、从列表中选择一个已安装 ipykernel 的 Python 环境（如 conda 或 venv 路径下的 python 可执行文件）。

4、重启当前 Jupyter Notebook 文件，观察内核状态栏是否显示“Ready”。

二、手动安装并注册 ipykernel

当所选 Python 环境中缺失 ipykernel 时，Jupyter 扩展无法创建可识别的内核实例，需在目标环境中显式安装并注册。

1、在终端中激活目标 Python 环境（例如执行 conda activate myenv 或 source venv/bin/activate）。

2、运行命令 python -m pip install ipykernel。

3、执行 python -m ipykernel install --user --name myenv --display-name "Python (myenv)" 完成内核注册。

4、在 VSCode 中刷新内核选择下拉菜单，确认新注册的内核名称已出现并可选中。

三、禁用冲突扩展并重置 Jupyter 设置

部分扩展（如 Pylance 高版本、Python Test Explorer 或旧版 Jupyter 插件）可能与当前 Jupyter 扩展产生兼容性问题，导致单元格渲染失败或调试中断。

1、点击左侧活动栏的扩展图标，搜索 Jupyter，确保启用的是官方 Microsoft 发布的 Jupyter 扩展（ID：ms-toolsai.jupyter）。

2、禁用所有其他 Python 相关扩展（除 Pylance 和 Python 外），尤其是名称含 jupyter-notebook 或 vscode-jupyter 的第三方扩展。

3、打开设置（Cmd+, ），搜索 jupyter.askForKernelRestart，将其设为 false；再搜索 jupyter.enableExtendedPythonEnvironmentSupport，设为 true。

四、清除 Jupyter 运行时缓存

VSCode 会缓存内核连接信息与临时运行时目录；若缓存损坏，可能导致单元格执行卡在“Busy”状态或反复断连。

1、关闭所有打开的 .ipynb 文件及 VSCode 窗口。

2、在终端中执行 rm -rf ~/.vscode/extensions/ms-toolsai.jupyter-*/out/webviews（macOS/Linux）或在 Windows PowerShell 中运行 Remove-Item -Recurse -Force "$env:USERPROFILE\.vscode\extensions\ms-toolsai.jupyter-*\out\webviews"。

3、删除当前工作区下的 .vscode/jupyter.json（如有）。

4、重新启动 VSCode 并打开 Notebook 文件，等待扩展自动重建运行时。