code --install-extension失败需满足三个硬性条件：一是必须先执行Shell Command注册code命令；二是.vsix路径须为带引号的绝对路径；三是离线环境需加--allow-unverified参数绕过签名校验。
code --install-extension 命令总失败？先看这三个硬性条件
命令行安装看似最“干净”，但实际卡点极隐蔽，失败时往往只报 INVALID_SIGNATURE 或静默无反应。根本原因不是网络，而是三个前提没满足：
- VSCode 必须已启用 Shell Command：在 VSCode 中按
Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行，否则code命令根本不可用 -
.vsix文件路径必须是**绝对路径**，且含空格或中文时需加英文双引号，例如：code --install-extension "/mnt/usb/python-2024.6.0.vsix" - 离线环境默认会校验微软签名，但内网无法访问证书链——必须显式加
--allow-unverified参数，否则直接拒绝安装
装完插件却没功能？大概率是版本或架构不匹配
VSCode 对不兼容插件的处理非常安静：不报错、不提示、只是跳过加载。打开 .vsix 解压后的 package.json，重点查两处：
-
"engines": {"vscode": "^1.85.0"}—— 运行code --version输出如1.84.2，则主版本1.84 < 1.85，插件会被静默忽略 - 含 native 二进制的插件（如
volarjs.volar、ms-python.pylance）必须匹配目标机器架构：ARM Mac 上装 x64 版本的.vsix，server 二进制根本跑不起来
验证方式：检查 ~/.vscode/extensions/volarjs.volar-*/server/ 目录下是否存在对应平台的 volar-server（如 volar-server-darwin-arm64）。
依赖插件漏装导致功能残缺？别信“推荐”列表
手动下载单个 .vsix 很容易漏掉隐式依赖。比如装了 esbenp.prettier-vscode 却没装 bradlc.vscode-tailwindcss，格式化时可能直接崩溃；装了 ms-python.python 却没装 ms-python.pylance，类型提示就全失效。
- 最稳做法：在一台已配好的联网机器上运行
code --list-extensions > extensions.txt，导出完整 ID 列表 - 批量下载时用
vsce download（非 GitHub Release 页面），它能自动解析依赖并拉取对应版本，例如：vsce download ms-python.python@2024.6.0 - 切勿依赖插件页面写的 “Recommended extensions” —— 那只是市场推荐栏，不是真实依赖树
含 language server 的插件（如 Volar）离线生效的关键动作
Volar、Pylance、Rust Analyzer 这类插件，.vsix 只打包前端逻辑，真正的语言服务（LSP server）是独立二进制，离线安装后常卡在 “Loading…” 状态。
- 推荐路径：在同版本联网机器上完整安装该插件 → 打开一个
.vue或.py文件等状态栏显示 “Volar: Ready” → 直接拷贝整个volarjs.volar-*/目录到内网机的~/.vscode/extensions/下 - 应急路径：解压
.vsix，从插件 GitHub Releases 页面下载对应平台的 server 二进制（如volar-server-darwin-arm64），放入解压后目录的server/子目录，再整体移入extensions/ - 注意：拷贝后必须彻底退出 VSCode（包括托盘进程），否则旧缓存不会刷新
真正难的不是下载或安装，而是确认那个 server/ 目录里有没有东西、版本对不对、架构匹不匹配——这三步跳过，插件就永远只是“已安装”，不是“能用”。
