code --install-extension是唯一可靠入口，因图形界面依赖网络校验签名、触发解压和注册，断网时静默中断；命令行能即时返回兼容性、路径或架构错误，便于精准排查。
Linux服务器上离线装VSCode插件，code --install-extension 是唯一可靠入口，图形界面在无网/权限受限环境大概率静默失败。
为什么不能点“Install from VSIX”？
扩展面板依赖后台服务校验签名、触发解压和注册，断网时流程直接中断，不报错也不提示——你拖进去了，它就当没看见。命令行能立刻返回真实错误，比如 Extension is not compatible with Code 或 ENOENT，便于快速定位是路径错、版本低，还是 ARM/x64 架构不匹配。
用 code --install-extension 必须注意的三件事
- 必须用绝对路径：
code --install-extension /home/user/vsix/ms-python.python-2024.6.0.vsix，相对路径在脚本或 SSH 终端里基本无效 - 路径含空格或中文？加英文双引号：
code --install-extension "/home/user/my ext.vsix" - 先确认
code命令可用：运行code --version；若提示command not found: code，需在有 GUI 的机器上打开 VSCode，按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行
插件装上了却没反应？检查兼容性比重装更有效
VSCode 对不兼容插件的处理非常安静：跳过加载，不报错，也不出现在已启用列表里。
- 解压
.vsix文件（unzip -l xxx.vsix），打开里面的package.json - 找
"engines": {"vscode": "^1.80.0"}字段，记下最小要求版本（如^1.85.0） - 在服务器上运行
code --version，取输出第一位小数点前的数字（如1.85.2→1.85），必须 ≥ 插件要求值 - ARM 服务器上装了 x64 构建的插件（尤其含 native binary 的），会静默失效；得确认 vsix 名称或
package.json中是否含darwin-arm64或linux-arm64
连 CLI 都不可用？手动复制到 extensions 目录是最后手段
适用于无 GUI、权限锁死或 code 命令彻底不可用的服务器环境，但容错极低，一步错就得全删重来。
- 用
unzip -l xxx.vsix查顶层目录名，例如ms-python.python-2024.6.0/—— 这就是扩展 ID + 版本，必须原样作为子目录名 - 把整个该目录复制进：
$HOME/.vscode/extensions/（注意不是只复制里面的内容，也不能留着 .vsix 文件） - 复制完必须彻底退出 VSCode：查
ps aux | grep code，杀掉所有相关进程，否则缓存不刷新，插件不会加载
最常被忽略的是版本兼容性和架构匹配——特别是 ARM 服务器上用了 x64 插件，或者 VSCode 是 1.82 而插件要求 1.85，这种问题不会报错，只会让你反复怀疑是不是操作错了。
