清除VSCode旧远程Jupyter内核连接,默认使用本地/指定解释器内核
解决VSCode中Jupyter远程内核列表冗余及默认内核错误问题
核心解决方案
1. 强制禁用远程Jupyter服务器连接
打开VSCode设置(快捷键Ctrl+,),搜索jupyter.serverURI,将其设置为空字符串""。也可以直接编辑settings.json(快捷键Ctrl+Shift+P输入Preferences: Open Settings (JSON)),添加或修改如下配置:
"jupyter.serverURI": ""
这会让VSCode默认仅加载本地内核,不再连接之前配置的JupyterHub远程服务器。
2. 让Jupyter自动匹配当前选中的Python解释器
在settings.json中添加以下配置,实现打开笔记本或交互式Python文件时自动使用当前已选定的Python解释器作为内核:
"jupyter.selectKernelOnOpen": true, "jupyter.defaultKernelPath": "${python.pythonPath}"
3. 过滤远程内核(可选)
如果仍有远程内核残留,可通过内核过滤规则彻底屏蔽。在settings.json中添加:
"jupyter.kernels.filter": { "exclude": ["Python 3", "venv"] // 替换为你要移除的远程内核名称 }
将括号内的内容替换为你实际要排除的远程内核名称,确保和列表中的显示一致。
清理残留配置(若上述方法无效)
- 检查工作区设置:打开当前工作区的
.vscode/settings.json,删除任何jupyter.serverURI相关配置,避免工作区覆盖全局设置。 - 清理Jupyter缓存:删除
%APPDATA%\Code\User\workspaceStorage下所有含jupyter关键字的文件夹,清除VSCode存储的旧连接数据。 - 删除本地远程内核配置:打开
C:\Users\你的用户名\.jupyter\kernels,如果存在远程内核的配置文件夹,直接删除即可。
Remote-SSH场景适配
当通过Remote-SSH连接Linux服务器开发时,在远程VSCode窗口中单独配置Jupyter设置(远程窗口的设置不会影响本地):
- 远程窗口中设置
jupyter.serverURI为空,让其加载服务器本地的内核; - 本地窗口保持之前的配置,仅加载Windows本地内核,实现本地/远程环境的隔离。
内容的提问来源于stack exchange,提问作者Kyle Carow
相关产品推荐
相关产品推荐

