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等未被占用端口。
