远程插件卡在Installing,90%是VSIX未传到远程;执行ls -lt ~/.vscode-server/extensions | head -n 3验证:无新目录则传输失败,有新目录仍卡住则扩展宿主异常或权限问题。

远程插件卡在 Installing,先确认是不是 VSIX 没传过去
VS Code Remote-SSH 安装插件时卡住,90% 的情况是 VSIX 文件根本没成功传到远程服务器。它不是本地装完再同步,而是本地下载(或指定).vsix 后,通过 SSH 通道把文件复制到远程的 ~/.vscode-server/extensions/ 目录下,再由远程扩展宿主解压注册。如果远程机器 DNS 解析慢、出站 443 被限、或 SSH 传输被中断,VSIX 就会“消失”在半路。
快速验证方法:
打开远程终端,执行:ls -lt ~/.vscode-server/extensions | head -n 3
如果最新目录时间戳比你点击安装的时间还早,说明 VSIX 没落地;如果刚生成了一个带随机名的新目录,但插件仍显示 installing,问题大概率出在扩展宿主没重启或权限不对。
- 别信输出面板里“Remote-SSH”日志没报错就等于正常——它常静默超时
- 不要反复重装本地 VS Code,重点检查远程的
~/.vscode-server目录是否可写 - 如果远程服务器禁外网,
marketplace.visualstudio.com这个域名根本解析不了,必须绕过在线流程
用 code --install-extension 命令手动装 VSIX 到远程
这是最稳、最可控的方式,不依赖 UI 状态,也不走 Marketplace 查询链路。前提是:你已通过 SCP/SFTP/共享目录等方式,把 .vsix 文件放到远程某处(比如 /tmp/my-ext.vsix)。
在远程终端中执行:code --install-extension /tmp/my-ext.vsix
- 命令必须在远程环境里运行,且
code命令需指向 VS Code Server 的二进制(通常已自动配置好) - 如果提示
command not found: code,说明远程~/.vscode-server/bin/下的COMMIT_ID目录未加入$PATH,可临时补全路径:~/.vscode-server/bin/abcd1234/code --install-extension ... - 成功后会输出
Extension 'xxx' was successfully installed.,失败则明确报错,比如Unsupported extension version或EACCES: permission denied - 装完不用重启 VS Code,但部分插件(如 Pylance、C/C++)需要重新打开文件夹才能激活语言服务
从本地 VS Code UI 手动选 VSIX 安装,但要确保装到远程侧
很多人点“从 VSIX 安装”后选了文件,结果插件只装在本地,对远程项目完全无效。关键在于:VS Code 会根据当前窗口上下文决定安装目标——只有在 Remote-SSH 连接已建立、且窗口标题栏显示 “SSH: xxx” 的前提下,UI 才会把 .vsix 推送到远程。
- 必须先用 Remote-SSH 成功连接上远程主机,再打开扩展面板(
Ctrl+Shift+X) - 点击右上角三个点 → “Install from VSIX…” → 此时弹出的文件选择器默认挂载的是远程文件系统(不是你本地磁盘)
- 如果你提前把
.vsix上传到了远程(比如/home/user/ext.vsix),直接导航过去选中即可 - 如果弹窗里看不到远程路径,说明当前不是远程会话上下文——检查左下角状态栏有没有 SSH 连接标识,或重新用 “Connect to Host in New Window” 打开
装完插件还要配 TaoToken?重点改 workspace 层配置
很多 AI 类插件(Continue、Cline、Tabby)装完只是第一步。它们默认调用 https://api.openai.com/v1/chat/completions 这类公网 endpoint,在远程服务器上十有八九连不通。换成 TaoToken 后,必须确保请求是从远程端发出的,而不是本地 VS Code 发起。
- 配置项必须写在远程项目的
.vscode/settings.json或远程用户级~/.vscode-server/data/Machine/settings.json中,不能只改本地设置 - 典型配置字段如:
"continue.endpoint": "https://taotoken.example.com/v1"、"taotoken.apiKey": "sk-xxx" - 改完保存后,打开一个远程 Python/JS 文件,看插件右下角状态栏是否显示 “Connected to TaoToken”,而不是 “Failed to connect”
- 如果仍报连接失败,用远程终端执行:
curl -v https://taotoken.example.com/health,确认是网络问题还是鉴权问题
最易忽略的一点:插件的「运行位置」和「配置加载位置」必须一致。离线装的 VSIX 是 workspace 扩展,但配置若只存在本地,远程端根本读不到——这比装不上更难排查。


















