VSCode中Jupyter Notebook问题可按四步解决：一、重装Microsoft官方Jupyter扩展；二、手动指定含jupyter的Python解释器路径；三、选择本地Jupyter Server并启动；四、清除workspace中jupyter相关配置项。
如果您在vscode中使用jupyter notebook进行数据分析或模型开发，却遇到内核无法启动、单元格执行无响应、markdown渲染异常或变量查看器不显示等问题，则可能是由于扩展配置、python环境绑定或notebook服务状态异常所致。
本文运行环境：MacBook Air，macOS Sequoia。
一、检查并重装Jupyter扩展
VSCode依赖官方Jupyter扩展提供Notebook核心功能，扩展损坏或版本不兼容会导致内核加载失败或界面元素缺失。
1、点击左侧活动栏的扩展图标（或按快捷键Ctrl+Shift+X）。
2、在搜索框中输入Jupyter，确认已安装Microsoft官方发布的Jupyter扩展（发布者为Microsoft）。
3、若已安装，点击其右侧的三个点，选择“卸载”，重启VSCode后重新搜索安装。
4、安装完成后，打开任意.ipynb文件，观察右下角是否出现Python环境选择提示。
二、手动指定Python解释器路径
VSCode可能未自动识别系统中已安装的jupyter包所在Python环境，导致内核无法连接。
1、打开命令面板（Cmd+Shift+P），输入并选择“Python: Select Interpreter”。
2、在弹出列表中查找包含/bin/python或/venv/bin/python路径的选项，优先选择已安装jupyter的环境。
3、若列表为空，点击“Enter interpreter path...”，手动输入类似/opt/homebrew/bin/python3或~/miniforge3/bin/python的完整路径。
4、确认后，新建一个空白Notebook，运行import jupyter验证是否报错。
三、启用本地Jupyter Server而非Remote Kernel
VSCode默认尝试复用已运行的Jupyter服务，若该服务崩溃或端口被占用，将导致Notebook卡在“Connecting to kernel…”状态。
1、打开命令面板（Cmd+Shift+P），输入并选择“Jupyter: Specify Jupyter Server for Connections”。
2、选择“Local Jupyter Server”而非“Existing Jupyter Server”或“JupyterHub”。
3、若提示“Start local Jupyter server”，点击确认，等待VSCode自动拉起后台进程。
4、观察VSCode右下角是否显示Jupyter Server: Local及对应端口号（如:8888）。
四、重置Notebook工作区设置
用户级或工作区级的settings.json中可能存在冲突配置，例如禁用变量查看器、覆盖默认渲染器或强制使用旧版Notebook格式。
1、打开命令面板（Cmd+Shift+P），输入并选择“Preferences: Open Workspace Settings (JSON)”。
2、查找并删除包含"jupyter."前缀的所有行，例如"jupyter.askForKernelRestart"、"jupyter.defaultKernel"等。
3、保存文件后，关闭当前Notebook标签页，重新通过文件菜单→“Open Notebook”打开同一文件。
4、执行首个单元格，确认变量面板是否恢复显示且输出区域支持LaTeX与图像内联渲染。
