VSCode 中 Jupyter Notebook 无法正常运行，需依次完成五步配置：安装官方 Jupyter 扩展、正确选择含 jupyter 的 Python 解释器、手动注册 IPython 内核、启用 Notebook 默认格式支持、通过开发者工具查看日志排查端口或权限问题。
如果您在 VSCode 中使用 Jupyter Notebook 进行数据分析或机器学习开发，但发现内核无法启动、代码单元执行异常或扩展功能缺失，则可能是由于插件配置不当、Python 环境未正确关联或内核注册失败所致。以下是实现二者稳定协同工作的具体操作：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装并启用 Jupyter 扩展
VSCode 需通过官方 Jupyter 扩展支持 Notebook 原生编辑与交互式执行，该扩展提供语法高亮、变量查看器、内核选择及实时输出渲染等功能。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Ctrl+Shift+X）。
2、在搜索框中输入Jupyter，找到由 Microsoft 发布的官方扩展，名称为“Jupyter”且作者显示为“Microsoft”。
3、点击“安装”，安装完成后点击“重新加载”按钮使扩展生效。
二、配置 Python 解释器路径
VSCode 必须识别到包含 jupyter 包的 Python 环境，否则 Notebook 将无法启动内核；此步骤确保 VSCode 调用正确的 Python 可执行文件及对应 site-packages。
1、在 VSCode 中按下 Ctrl+Shift+P，打开命令面板。
2、输入并选择“Python: Select Interpreter”命令。
3、在弹出列表中选择已安装 jupyter 的 Python 环境，例如 /usr/local/bin/python3 或~/miniconda3/envs/pydata/bin/python；若目标环境未出现，需先在终端中运行 pip install jupyter 或conda install jupyter。
三、手动注册 Jupyter 内核
当 VSCode 自动检测不到内核时，需在目标 Python 环境中显式注册 IPython 内核，使其被 VSCode 的 Jupyter 扩展识别为可用内核选项。
1、在终端中激活目标 Python 环境，例如执行 conda activate pydata 或source ~/venvs/ml/bin/activate。
2、运行命令：python -m ipykernel install --user --name pydata --display-name "Python (pydata)"。
3、重启 VSCode，在 Notebook 右上角内核选择器中应可见 Python (pydata) 选项。
四、启用 Notebook 默认格式支持
VSCode 默认以 JSON 格式保存。ipynb 文件，但部分协作场景需兼容传统 Jupyter Lab 行为，包括自动保存检查点、单元格折叠状态持久化等。
1、打开 VSCode 设置（Ctrl+,），切换至“设置”标签页。
2、搜索关键词notebook: default kernel，确认其值为当前已注册的内核名称。
3、继续搜索notebook: save and backup，勾选“Notebook: Auto Save”和“Notebook: Backup On Save”两项。
五、调试与日志排查
当 Notebook 仍无法执行时，可通过 VSCode 内置日志系统定位问题根源，包括内核启动失败、端口 冲突或权限拒绝等低层错误。
1、按下 Ctrl+Shift+P，输入并选择“Developer: Toggle Developer Tools”。
2、切换到“Console”面板，执行一个单元格，观察是否有红色报错信息，如 Failed to start Jupyter server 或Permission denied: /tmp/jupyter-*。
3、若提示端口占用，可在设置中修改“Jupyter: Localhost Port”，指定为 8889 等未被占用端口。
