离线安装VSCode插件失败主因是.vsix与环境不匹配：版本/路径/签名/依赖任一不符。CLI安装须用绝对路径加引号，签名错误需加--allow-unverified，装后须彻底退出VSCode并验证扩展目录及服务是否完整。
离线安装 VSCode 插件失败，90% 不是因为操作错，而是 .vsix 没对上环境——版本不兼容、路径不对、签名被拦、或根本没加载依赖。直接拖进窗口不管用，靠图形界面提示“已安装”也不代表能用。
code --install-extension 必须用绝对路径且加引号
VSCode CLI 对路径极其敏感，相对路径、空格、中文、斜杠方向全都会导致静默失败（不报错，也不装）。
-
code --install-extension ./prettier.vsix→ 大概率失败，尤其在脚本中 -
code --install-extension C:\Users\Me\Downloads\prettier.vsix→ Windows 下反斜杠易被转义，推荐改用正斜杠：code --install-extension C:/Users/Me/Downloads/prettier.vsix - 路径含空格或中文？必须加英文双引号：
code --install-extension "C:/My Tools/vscode-ext/python-2024.6.0.vsix" - Linux/macOS 同理：
code --install-extension "/home/user/ext/ms-python.python-2024.6.0.vsix"
报 INVALID_SIGNATURE 就得加 --allow-unverified
内网离线环境无法连接微软证书服务器，code --install-extension 默认会校验签名，失败时只报 INVALID_SIGNATURE，不解释原因。
- 正确做法：加
--allow-unverified参数绕过签名检查：code --install-extension python.vsix --allow-unverified - 这个参数只影响签名验证，不影响插件功能或安全性（你已控制下载源）
- 注意：不是
--ignore-signature或--skip-verify，其他参数无效
装完不生效？先查 extensions 目录和托盘进程
VSCode 会缓存扩展状态，即使命令行显示 “successfully installed”，也可能因未彻底重启而无法加载。
- Windows 路径：
%USERPROFILE%\AppData\Roaming\Code\Extensions\，确认对应插件目录是否存在（如ms-python.python-2024.6.0\） - macOS/Linux 路径：
$HOME/.vscode/extensions/ - 必须彻底退出 VSCode：右下角托盘图标也要右键「Quit」，否则旧进程仍在，新扩展不会初始化
- 验证是否真加载：打开命令面板（
Ctrl+Shift+P），输入插件相关命令（如Python: Select Interpreter），能调出即为成功；若无响应，看Output面板里对应插件通道是否有spawn ENOENT或Failed to fetch
插件显示已安装但功能缺失，大概率缺语言服务器
像 ms-python.python、Vue Language Features (Volar) 这类插件，.vsix 只是外壳，首次启用才会下载 pyright、volar-server 等二进制服务。离线环境卡在这里，界面毫无提示。
- 解决方法：在有网机器上完整触发一次——打开一个
.py文件，等状态栏不再显示 “Downloading…”；再把整个$HOME/.vscode/extensions/ms-python.python-2024.6.0/目录拷到离线机对应位置 - 不能只拷
.vsix，也不能只拷node_modules；native 二进制藏在子目录（如dist/server/pyright），漏一个就启动失败 - ARM Mac 上装 x64 构建的插件会静默失效，必须确认
.vsix名称或package.json中是否含darwin-arm64
最易被忽略的一点：插件页面写的 “Recommended” 是推荐栏，不是依赖树；真实依赖藏在 .vsix 解压后 extension/package.json 的 extensionDependencies 字段里——漏掉一个，格式化、跳转、补全全崩。
