Remote-SSH离线安装成功不等于可用，关键在vscode-server手动部署：需下载与本地VSCode Commit ID一致的vscode-server-linux-x64.tar.gz和vscode_cli_alpine_x64_cli.tar.gz，上传至服务器~/.vscode-server/目录；语言插件（如Python）还需同步其扩展目录及已下载的LSP二进制文件。
离线安装 VSCode 远程连接相关扩展（如 Remote - SSH）本身不难，但**装上 ≠ 能用**——真正卡住的是后续的 vscode-server 自动下载失败，以及扩展依赖的 CLI 工具缺失。必须把“扩展安装”和“远程服务部署”当作一个整体来处理。
Remote - SSH 扩展离线安装最稳方式：拖 .vsix 到主编辑区
这是成功率最高、不触发任何网络请求的方式，但有硬性前提：
- VSCode 必须已启动，并且已通过 File → Open Folder… 加载任意工作区（哪怕只是空文件夹）
- 窗口要有系统焦点（任务栏图标高亮），不能全屏、不能处于远程连接未就绪状态
- 拖拽目标必须是代码编辑区域（白色主面板），不是侧边栏、不是设置页、不是终端
- 右下角状态栏不能显示
Extensions disabled by policy（否则组策略已锁死，GUI 和 CLI 均无效）
从官方市场下载 ms-vscode-remote.remote-ssh-0.107.0.vsix（版本号随你本地 VSCode 版本浮动）后，直接拖入即可。安装后插件默认禁用，需手动点「启用」或重启 VSCode。
为什么装了 Remote - SSH 还连不上服务器？关键在 vscode-server
Remote - SSH 只是客户端桥接器，真正运行在远端的是 vscode-server。离线环境下，VSCode 默认会尝试从外网下载它，失败后卡在「正在安装远程服务器…」并最终报错：
Failed to download and install vscode-server这不是扩展没装好，而是远端缺服务包。解决办法是手动部署两个核心文件：
-
vscode-server-linux-x64.tar.gz：服务主包，路径中linux-x64需与服务器架构一致（ARM 服务器要换linux-arm64） -
vscode_cli_alpine_x64_cli.tar.gz：新版必备 CLI 启动工具（旧版地址已失效，必须用新域名）
Commit ID 必须与本地 VSCode 完全一致（Help → About 里复制那串 40 位哈希），否则远端启动时校验失败，报 commit mismatch。
code --install-extension 命令离线安装的实操要点
适合脚本化批量部署，但对路径和环境极其敏感：
- Windows 下路径含空格必须加双引号：
code --install-extension "C:\ext\ms-vscode-remote.remote-ssh-0.107.0.vsix" - Linux/macOS 必须用绝对路径：
code --install-extension /home/user/ext/ms-vscode-remote.remote-ssh-0.107.0.vsix - 若提示
command not found: code，说明 CLI 未注册：按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - 覆盖旧版加
--force参数，避免因版本冲突静默跳过
注意：code --install-extension 不会自动拉取 vscode-server，它只管扩展本身。远程连接仍需你手动上传解压那两个 .tar.gz 包到服务器 ~/.vscode-server/ 目录下。
离线环境最容易被忽略的坑：语言插件依赖的 LSP 二进制
如果你后续要在远程服务器上写 Python，光装 Remote - SSH 和 ms-python.python 远不够。后者首次启用会尝试下载 pyright 或 debugpy，离线时卡在状态栏 Downloading Pylance…，输出面板报 spawn ENOENT。
正确做法不是重装 .vsix，而是在有网机器上：
- 打开一个
.py文件，等状态栏变绿（表示 LSP 启动成功） - 完整拷贝整个扩展目录：
~/.vscode/extensions/ms-python.python-2024.6.0/（含node_modules和已下载的二进制） - 连同
ms-python.vscode-pylance-2024.6.0/一起复制到离线机对应路径
否则，即使远程连接成功，Python 补全、调试、格式化全部失效——这个环节比装 Remote - SSH 本身更常出问题。
