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，确保两个扩展状态均为已启用。

二、配置默认 Python 解释器并关联 Jupyter 内核

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。

三、手动注册 Python 环境为 Jupyter 内核

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

AI Sofiya

一款AI驱动的多功能工具

147

查看详情

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”，新注册的内核名称将出现在列表中。

四、禁用冲突的 Notebook 渲染插件

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

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

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

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

五、重置 Notebook 工作区设置

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

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

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

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

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

以上就是VSCode对原生Jupyter Notebook(.ipynb)文件的支持的详细内容，更多请关注php中文网其它相关文章！