VSCode对原生Jupyter Notebook(.ipynb)文件的支持_网络技术

需安装启用Python与Jupyter官方扩展、配置默认Python解释器并关联内核、手动注册ipykernel、禁用冲突渲染插件、重置notebook相关设置。

如果您在 Visual Studio Code 中打开原生 Jupyter Notebook（.ipynb）文件，但无法正常执行代码单元、缺少内核选择或渲染异常，则可能是由于扩展配置、Python 环境绑定或内核注册状态导致。以下是实现稳定支持的具体操作：

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

一、安装并启用 Python 与 Jupyter 扩展

VSCode 对 .ipynb 文件的原生支持依赖于官方维护的扩展组件，必须确保 Python 和 Jupyter 扩展同时启用且版本兼容。

1、打开 VSCode 的扩展视图，点击左侧活动栏中的方块图标或按 Cmd+Shift+X。

2、在搜索框中输入 Python，找到由 Microsoft 发布的官方扩展，点击“安装”。

3、再次搜索 Jupyter，安装同为 Microsoft 发布的 Jupyter 扩展（注意名称为 “Jupyter”，非 “Jupyter Notebooks” 或第三方变体）。

4、安装完成后，重启 VSCode，确保两个扩展状态均为已启用。

VSCode 需明确知道使用哪个 Python 环境作为 Jupyter 内核来源，否则将无法运行代码单元或显示变量面板。

1、打开任意 .ipynb 文件，点击右上角显示“Select Kernel”的按钮。

2、在弹出菜单中选择 Enter interpreter path... 或 Python Environments 选项。

3、浏览至本地 Python 可执行路径，例如：/usr/local/bin/python3 或虚拟环境中的 ~/venv/bin/python。

4、确认后，VSCode 将自动检测并注册该环境下的 ipykernel，若未安装，会提示运行 pip install ipykernel。

当 VSCode 无法自动识别已安装的 ipykernel 时，需通过命令行显式注册，使内核出现在内核选择列表中。

1、在终端中激活目标 Python 环境（如使用 conda，则运行 conda activate myenv；如为 venv，则运行 source ~/venv/bin/activate）。

2、执行命令：python -m ipykernel install --user --name myenv --display-name "Python (myenv)"。

3、关闭并重新打开 VSCode，再次点击“Select Kernel”，新注册的内核名称将出现在列表中。

部分第三方扩展（如旧版 “Jupyter Notebook Renderer” 或 “vscode-jupyter” 分支变体）会覆盖原生 Notebook 视图逻辑，导致单元格无法编辑或输出不刷新。

1、在扩展视图中搜索关键词 notebook renderer 或 jupyter legacy。

2、对名称含 Legacy、Classic 或非 Microsoft 官方签名的 Notebook 相关扩展，全部点击“停用”。

3、重启 VSCode，仅保留 Microsoft 发布的 Python 与 Jupyter 扩展处于启用状态。

用户自定义设置可能覆盖默认 Notebook 行为，例如禁用了交互式窗口、关闭了变量查看器或强制启用了只读模式。

1、按下 Cmd+, 打开设置界面，在搜索框中输入 notebook.editorOptions。

2、找到该项后，点击右侧的垃圾桶图标将其重置为默认值。

3、继续搜索 notebook.defaultKernel，清除其手动指定的值。

4、关闭设置页，重新打开一个 .ipynb 文件验证内核是否可选、单元格是否可执行。