VSCode Remote 插件安装卡住或失败，主因是远程机器网络不通（如无法访问 marketplace）、缺少编译工具或 Node.js 环境、插件不支持 Remote 模式；应检查网络、手动配置代理、安装构建依赖、使用离线安装，并确认插件兼容性与安装位置。
Remote SSH 连接后插件安装显示 “Installing…” 卡住或报 connect ECONNREFUSED
本质是 VSCode Remote 的插件安装走的是远程机器上的网络路径，但远程服务器通常没配代理、没开外网访问权限，或 DNS 解析失败。本地能装的插件，远程会直接尝试在远端发起 https://marketplace.visualstudio.com 请求——而这个请求大概率被墙、超时或被防火墙拦截。
实操建议：
- 确认远程机器能否通外网：
curl -I https://marketplace.visualstudio.com；如果卡住或返回Failed to connect，说明网络不通，后续所有插件操作都会失败 - 不要依赖“自动转发代理”：VSCode Remote 默认不转发本地的
HTTP_PROXY环境变量到远程终端，需手动配置 - 在远程服务器的 shell 配置文件（如
~/.bashrc或~/.zshrc）里显式设置：export HTTP_PROXY=http://your-proxy:port<br>export HTTPS_PROXY=http://your-proxy:port
，然后重连 Remote 窗口（或执行source ~/.bashrc并重启 VSCode Server） - 若用公司内网/跳板机，且无法配代理，可改用「离线安装」：在本地下载
.vsix文件（从 marketplace 页面点击 “Download Extension”），再通过scp传到远程，最后在 VSCode Remote 的命令面板（Ctrl+Shift+P）运行Extensions: Install from VSIX...
Remote 环境下点击 Install 后提示 “Unable to install extension: X. Please check the log for more information”
常见于插件依赖原生模块（比如 eslint、prettier 的语言服务，或含 node-gyp 编译步骤的插件），而远程机器缺少构建工具链（python、make、gcc）或 Node.js 版本不匹配。
实操建议：
- 先在远程终端运行：
node -v和npm -v，确认版本是否满足插件要求（很多插件最低要求 Node.js 16+） - 检查缺失编译工具：
which python3 make gcc；缺哪个就装哪个（Ubuntu/Debian：sudo apt install build-essential python3；CentOS/RHEL：sudo yum groupinstall "Development Tools" && sudo yum install python3） - 某些插件（如
ms-python.python）会在 Remote 首次启用时后台拉取大量语言服务器二进制包，此时若远程磁盘满、/tmp 权限受限或 SELinux 开启，也会静默失败——查日志最直接：tail -f ~/.vscode-server/data/logs/*/exthost*/window*
已安装插件在 Remote 中不生效，或状态栏图标消失、命令不可用
VSCode 插件分三类：UI 层（只在本地运行）、Workspace 层（可跨 Remote 运行）、Remote 层（必须在远程安装）。用户常误以为“本地装了插件，Remote 就能用”，其实只有标有 "extensionKind": ["ui", "workspace"] 或明确支持 Remote 的插件才可能激活。
实操建议：
- 打开插件详情页，看右上角是否显示 “Works in Remote Window” 标签；没标的基本不能用（例如旧版
gitlens某些版本就不支持） - 插件安装位置不对：Remote 插件必须装在远程服务器的
~/.vscode-server/extensions/下，而非本地的~/.vscode/extensions/；手动复制无效，必须通过 Remote 界面或Install from VSIX触发安装流程 - 部分插件需额外配置才能启用 Remote 支持，比如
esbenp.prettier-vscode要确保远程项目里有.prettierrc或prettier.config.js，否则可能不加载格式化器
Remote 插件更新失败，提示 “Extension 'X' is not installed in this window”
这是 VSCode 的 Remote 架构导致的典型错觉：你看到的插件列表是“合并视图”，但实际状态是分离的。点“Update”时，VSCode 会按当前上下文决定更新哪边——如果当前焦点在本地窗口，它就只更新本地；如果在 Remote 窗口，才更新远程。但 UI 常不明显提示上下文切换状态。
实操建议：
- 务必确认当前窗口右下角是否显示
SSH: hostname或Dev Container；没显示就不是 Remote 上下文，所有插件操作都作用于本地 - 更新前先右键插件 → “Install in SSH: xxx”（而不是“Install”），或打开命令面板运行
Extensions: Install Extension in SSH: xxx - 避免混用同步设置（Settings Sync）：如果开启了 Settings Sync，本地和 Remote 的插件列表会被强制对齐，反而导致 Remote 自动卸载掉不兼容插件；建议关闭 sync 的 extensions 项：
"settingsSync.ignoredExtensions": ["*"]
真正麻烦的不是装不上，而是装上了但没跑在对的地方——Remote 插件的生命周期、网络路径、二进制依赖全由远端环境决定，本地一切顺畅都不能作为参考。每次换服务器、切镜像、升级 VSCode Server，都得重新验证这三件事：网络通不通、工具链全不全、插件声明支不支持 Remote。
