最稳方式是点击marketplace官方页面右下角“download extension”按钮获取带签名直链；手动拼url需严格匹配publisher（id点前）、extension_name（点后）和version（与requirements栏一致），否则404或旧版本。
能装，但必须严格匹配版本、架构和依赖链，否则静默失败——不是插件没装上，是 VSCode 根本不加载它。
下载 .vsix 文件时怎么避免 404 或旧版本
Marketplace 页面右下角的 “Download Extension” 按钮生成的是带签名的直链，最可靠；别信 GitHub Release 页或第三方镜像站。正确路径必须包含插件 ID 和版本号，例如：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2024.6.0/vspackage。手动拼 URL 时，publisher 是 ID 中 . 前半段（如 ms-python），extension_name 是后半段（如 python），version 必须和插件页面 Requirements 栏声明的完全一致（比如写明 “VS Code >= 1.85”，你就不能用 1.84 的 VSCode 装）。
code --install-extension 命令为什么总报错或没反应
三个高频卡点：
-
code命令不可用？不是 PATH 没配，而是 VSCode 没启用 Shell Command：按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 报
INVALID_SIGNATURE？离线环境无法校验证书链，加--allow-unverified参数：code --install-extension python.vsix --allow-unverified - 装完列表里有，但功能不生效？插件可能依赖其他扩展（如
ms-python.python强依赖ms-python.pylance），--list-extensions只显示已注册 ID，不保证运行时可用；重启 VSCode 后，用Developer: Show Running Extensions查看真实加载状态
手动解压到 extensions 目录的硬核操作要点
适用于无 GUI 或 CLI 不可用的服务器环境，但容错率极低：
- 先用
unzip -l xxx.vsix查顶层目录名，例如esbenp.prettier-vscode-9.10.3/—— 这就是扩展 ID + 版本，必须原样作为子目录名 - 解压后把整个该目录复制进：
%USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows）、$HOME/.vscode/extensions/（macOS/Linux） - 不能只复制里面的内容，也不能保留
.vsix文件本身 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新
含 native server 的插件（如 Volar）离线安装为何总卡在 “Loading…”
Volar、Vue Language Features 这类插件分两层：前端 UI（.vsix 里有）和后端语言服务器（volar-server 二进制）。只装 .vsix，等于只装了“遥控器”，没装“主机”。离线部署必须满足三要素：
- VSCode 版本 ≥
package.json中"engines": {"vscode": "^1.85.0"}声明的最低版本（用code --version对比主版本号） - 架构匹配：ARM Mac 必须用
darwin-arm64构建版，x64 机器装 arm64 版会直接失败 -
server/目录下必须存在对应平台的volar-server或volar-server.exe—— 若没有，需从 GitHub Release 手动下载并补入解压后的server/子目录
最稳做法是在联网机器上预热：安装插件 → 打开一个 .vue 文件 → 等状态栏显示 Volar: Ready → 再整目录拷贝过去。
