离线安装VSCode插件到服务器的核心难点是插件虽装上却无法启动，因Remote-SSH需vscode-server（版本须与本地完全一致）及插件整目录迁移（含node_modules和native二进制），且extensions.json路径必须手动修正并重启客户端验证。
离线安装 VSCode 插件到服务器环境，核心难点不在“装不上”，而在于“装上了却没功能”——尤其是 Remote-SSH 连接后，插件在远程服务器端（~/.vscode-server/extensions）根本没启动。直接拷 .vsix 文件过去、用 code --install-extension 命令执行，90% 会静默失败或卡在 “Downloading…”。
Remote-SSH 插件本身必须先在线安装并触发 server 下载
很多人以为只要本地装了 ms-vscode-remote.remote-ssh，就能连上内网服务器并自动部署插件。错。这个插件只负责建立连接，真正干活的 vscode-server 是另一套东西，它不随插件一起打包，必须单独下载、解压、放对位置。
-
vscode-server不是插件，是 VSCode 的服务端二进制，版本必须和你本地 VSCode 完全一致（比如本地是1.85.2，commit ID 是1e4a4e6b，那服务器端也得是这个 commit） - 不能靠浏览器随便搜 “vscode-server.tar.gz” 下载——第三方镜像常滞后、缺签名、甚至被篡改；唯一可靠来源是 VSCode 自己生成的直链：
https://update.code.visualstudio.com/commit:<code>1e4a4e6b/server-linux-x64/stable - 下载完要解压到
~/.vscode-server/bin/<code>1e4a4e6b/（路径名必须是 commit ID），不是bin/下其他目录，否则启动时找不到入口
远程服务器端插件必须整目录迁移，不能只传 .vsix
像 ms-python.python、esbenp.prettier-vscode 这类插件，在远程服务器上只装 .vsix 文件等于白装。它们的 LSP 二进制（如 pyright、prettier CLI）是在首次激活时才下载的，离线环境直接卡死。
- 正确做法：在一台与目标服务器**完全同构**的联网机器（相同 OS、glibc 版本、架构）上，用同一版本 VSCode 安装插件 → 打开对应文件（如
.py）→ 等 Output 面板显示Starting language server...→Server started→ 再去~/.vscode-server/extensions/打包整个插件目录（如ms-python.python-2024.6.0/） - 注意：目录名含版本号，且必须保留子目录里的
node_modules/和dist/下所有 native 二进制（ARM 服务器别误塞 x64 版） - 拷到内网服务器后，路径必须严格匹配：
~/.vscode-server/extensions/ms-python.python-2024.6.0/，不能多一层或少一层
extensions.json 路径字段需手动修正
VSCode Server 启动时会读取 ~/.vscode-server/data/Machine/extensions.json（不是用户家目录下的那个），里面存着每个插件的绝对路径。如果从别的机器整目录拷过来，路径前缀（如 /home/alice/.vscode-server/...）大概率和当前服务器不一致，导致插件被跳过加载，且无任何提示。
- 打开该文件，搜索所有
"path"字段，把旧路径替换成当前用户的实际路径（如/home/dev/.vscode-server/extensions/...） - 别漏掉数组里多个插件项；可用
sed -i 's|/old/path|/new/path|g' extensions.json批量替换（Linux/macOS） - 改完必须重启 VSCode 客户端（断开再重连 SSH），否则缓存不刷新
验证是否真生效，别信“已安装”列表
扩展面板里看到插件名字 ≠ 它在远程端跑起来了。很多插件状态栏不显示、命令面板搜不到、快捷键失灵，都是因为 LSP 没起来或路径错位。
- 打开 VSCode，连上远程服务器后，按
Ctrl+Shift+P输入Developer: Toggle Developer Tools，切到 Console 标签页，看有没有Extension host terminated或spawn ENOENT报错 - 打开 Output 面板，下拉选择对应插件通道（如
Python、Prettier、Vue Server），确认有初始化日志，而不是空的或报错 - 对 Python 插件，尝试
Python: Select Interpreter；对 Prettier，右键菜单选Format Document—— 能弹出选项才是真就绪
最易被忽略的一点：VSCode Server 进程一旦启动，就会锁住 extensions.json 和插件目录。哪怕你改完了文件、覆盖了目录，只要没彻底断开 SSH 连接（包括关闭 VSCode 客户端），旧进程还在读旧缓存。务必关客户端、杀光 code 相关进程，再重连。
