离线安装VS Code插件必须同时满足版本匹配、签名绕过、依赖补全、路径合法四条件，缺一则code --install-extension静默失败或装完不生效；需通过官方直链下载.vsix、加--allow-unverified参数安装、补全extensionDependencies依赖、确认os/targetPlatform与本地环境一致，并彻底退出VSCode进程后再安装。
离线安装 VS Code 插件不是“文件丢进去就能用”，而是必须同时满足版本匹配、签名绕过、依赖补全、路径合法这四个硬条件——缺一不可，否则 code --install-extension 会静默失败，或装完不生效。
怎么下载真正能用的 .vsix 文件
别信浏览器里点出来的任意“Download Extension”按钮，尤其在缓存页、镜像站或第三方聚合页面上，大概率返回 404 或旧版包。唯一稳的方式是走微软官方直链：
- 打开插件市场页，例如
https://marketplace.visualstudio.com/items?itemName=ms-python.python，滚动到底部 Resources 区域，右键点击 “Download Extension” → 复制链接地址，确认 URL 含_apis/public/gallery/publishers/字样 - 手动拼接更可控：用模板
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，其中publisher是 ID 小数点前半段（如ms-python），extension_name是后半段（如python），version必须和 Version History 里完全一致（如2026.6.123456） - 下载后重命名时带上平台标识，例如
python-2026.6.123456-darwin-arm64.vsix，避免 M 系列 Mac 上误装 x64 版
code --install-extension 报错的三个真实卡点
这个命令失败时通常只报一行模糊错误，但实际拦路虎就三个：
-
command not found: code？不是 PATH 没配，是 VSCode 从未启用 Shell Command：打开 VSCode →Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 报
INVALID_SIGNATURE？离线环境无法连微软证书服务器验签，必须加--allow-unverified参数：code --install-extension python.vsix --allow-unverified - 路径含中文或空格（如
C:\用户\张三\vsix\python.vsix）会静默失败；Windows 下推荐用正斜杠 + 双引号：code --install-extension "C:/vsix/python.vsix"
装完不生效？先查真实加载状态
code --list-extensions 能看到插件 ID，不代表它已激活——很多插件（如 ms-python.python）强依赖 ms-python.pylance，没它就是个空壳：
- 重启 VSCode 后，按
Ctrl+Shift+P→ 输入Developer: Show Running Extensions，看目标插件是否在“Running”列表中 - 若显示
Not activated或空白，打开该插件解压后的package.json，检查extensionDependencies字段，逐个补全依赖项 - ARM Mac 上装了 x64 构建的插件（尤其含 native binary 的，如
pyright），不会报错，只会跳过加载——必须确认.vsix文件名或package.json中的os和targetPlatform字段匹配本地环境
批量部署时怎么不漏掉隐式依赖
团队统一环境不能靠人肉点“推荐插件”，那种方式漏掉一个依赖，功能就断一半：
- 在已配好的联网机器上导出完整列表：
code --list-extensions > extensions.txt - 用
vsce download批量拉取（需先npm install -g vsce）：vsce download ms-python.python@2026.6.123456 - 注意
vsce不自动下载依赖，比如esbenp.prettier-vscode依赖bradlc.vscode-tailwindcss，得单独执行vsce download bradlc.vscode-tailwindcss
最易被忽略的点是：VSCode 启动后后台进程可能未完全退出，导致插件缓存未刷新——关掉所有实例（包括系统托盘里的），再重试安装，否则你改对了所有参数也白搭。
