You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

清除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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.23 11:06:19