离线安装vscode本体需下载官网原生安装包（如.exe/.tar.gz），而非.vsix文件；.vsix仅用于插件安装，编辑器本体不支持code --install-extension命令。
离线安装 VSCode 本身不需要 .vsix 文件，而是直接运行平台原生安装包（如 VSCodeSetup-x64-1.103.2.exe 或 code-stable-x64-1.103.2.tar.gz）——.vsix 只用于扩展插件，不是编辑器本体。
确认你要装的是 VSCode 编辑器本体，不是插件
很多人混淆“VSCode 离线安装”和“VSCode 插件离线安装”。前者是安装编辑器程序，后者才是用 .vsix。编辑器本体离线部署非常简单：
- 去官网 https://www.php.cn/link/30580a4caf21ef930b7774a2eff4aa26 下载对应系统（Windows/macOS/Linux）的离线安装包
- Windows：双击
VSCodeSetup-x64-*.exe，勾选“Add to PATH”可直接在终端用code命令 - macOS：拖拽
Visual Studio Code.app到 Applications 文件夹即可 - Linux：解压
tar.gz包后，把code可执行文件软链到/usr/local/bin/code或加入 PATH
为什么不能用 code --install-extension 装 VSCode 本身
这个命令只对扩展生效，VSCode 本体不是扩展，也没有对应的 .vsix 包。试图运行：
code --install-extension code-stable-x64-1.103.2.tar.gz
会报错：Extension 'code-stable-x64-1.103.2.tar.gz' is not a valid extension.
原因：.vsix 是 ZIP 格式、含 package.json 和激活逻辑的扩展包；而 .tar.gz 是二进制分发包，结构完全不同。
离线环境还要装 Remote-SSH？得同步部署 server 端
只装本地 VSCode 不够——Remote-SSH 插件依赖远程服务器上的 vscode-server。离线时必须手动部署：
- 先在联网机器上打开已安装 Remote-SSH 的 VSCode，执行
Developer: Show Developer Tools→ Console，输入location.href查看当前 commit ID（如8c9b53f3e7e09780719258156d8542812e1b3433） - 构造下载地址：
https://update.code.visualstudio.com/commit:8c9b53f3e7e09780719258156d8542812e1b3433/server-linux-x64/stable - 下载
vscode-server-linux-x64.tar.gz，上传到服务器的~/.vscode-server/bin/目录下并解压，重命名为该 commit ID 文件夹 - 确保服务器上已有
node（≥14.x），否则vscode-server启动失败
常见失败点：版本不匹配静默拒绝
VSCode 本体、Remote-SSH 插件、vscode-server 三者 commit ID 必须严格一致。哪怕只差一个字符，连接时就会卡在 “Installing VS Code Server” 并无提示。
验证方式：
- 本地 VSCode：命令面板执行
Help: About，第一行显示 commit ID - 插件版本：扩展页点 Remote-SSH → 小齿轮 →
Copy Extension ID，ID 中含版本号，但真正起作用的是底层 commit - 服务器端：检查
~/.vscode-server/bin/下文件夹名是否与本地 commit ID 完全一致
最容易被忽略的是：企业内网机器可能预装了旧版 VSCode，而你拷贝的是新版 .vsix 或 server 包——它们互不兼容，且错误日志藏在 ~/.vscode-server/data/logs/ 里，不主动查就一直黑盒。
