VSCode中Jupyter Notebook内核无法启动等问题,可依次通过重装Jupyter扩展、手动指定含jupyter的Python解释器、启用本地Jupyter Server、重置notebook/jupyter相关设置解决。

如果您在VSCode中使用Jupyter Notebooks进行数据分析或模型开发,但发现内核无法启动、单元格执行无响应或代码补全失效,则可能是由于扩展配置异常、Python环境未正确关联或Notebook服务未就绪。以下是解决此问题的步骤:
本文运行环境:MacBook Pro,macOS Sequoia。
一、验证并重装Jupyter扩展
VSCode依赖官方Jupyter扩展提供Notebook核心功能,若扩展损坏或版本不兼容,将导致内核加载失败或界面渲染异常。
1、点击左侧活动栏的扩展图标(方块拼图形状)。
2、在搜索框中输入Jupyter,确认已安装Microsoft发布的官方扩展(ID为ms-toolsai.jupyter)。
3、若已安装,点击扩展右侧的齿轮图标,选择“卸载”,重启VSCode后重新搜索安装。
4、安装完成后,打开任意.ipynb文件,观察右下角是否显示Python环境路径及内核状态。
二、手动指定Python解释器路径
VSCode可能未能自动识别系统中已安装的Python环境,尤其当存在多个conda或venv环境时,Notebook将因找不到有效内核而停滞。
1、使用快捷键Cmd+Shift+P(macOS)或Ctrl+Shift+P(Windows/Linux)打开命令面板。
2、输入并选择“Python: Select Interpreter”。
3、在列表中选择包含jupyter包的环境,例如/opt/anaconda3/bin/python或~/miniconda3/envs/data-science/bin/python。
4、保存后新建一个空白Notebook,运行第一个单元格验证内核是否成功连接。
三、启用本地Jupyter Server而非Remote Kernel
VSCode默认尝试连接远程Jupyter服务,若本地未运行jupyter server进程,Notebook将卡在“Connecting to kernel”状态。
1、终端中执行命令:jupyter notebook --no-browser --port=8888。
2、等待输出中出现类似“The Jupyter Notebook is running at: http://localhost:8888/”的提示。
3、切换回VSCode,在Notebook右上角点击内核选择器,选择“Jupyter Server: Local”。
4、点击任意单元格右侧的运行按钮,确认执行结果即时返回且无超时提示。
四、重置Notebook相关设置项
用户自定义的settings.json中若存在冲突配置(如notebook.lineNumbers、jupyter.askForKernelRestart等),可能导致渲染逻辑异常或交互中断。
1、按Cmd+Shift+P打开命令面板,输入并选择“Preferences: Open Settings (JSON)”。
2、查找并删除所有以"notebook."或"jupyter."开头的行。
3、保存文件后关闭所有Notebook标签页。
4、重新打开一个.ipynb文件,观察是否恢复默认交互行为与语法高亮。










