真正能用的.vsix文件必须通过官方市场页“download extension”按钮下载或用api拼url（含准确publisher、extension_name和version）；离线安装需加--allow-unverified参数、关闭所有vscode实例、确保vscode版本与插件engines.vscode严格匹配，并在联网机预触发lsp后整目录迁移。
能直接下载到本地的.vsix文件，必须从 VS Code 官方市场页点击 Download Extension 按钮，或用官方 API 拼出带签名的直链；其他任何来源（GitHub Release、镜像站、搜索引擎快照）大概率版本错、没签名、或平台不匹配，离线安装时直接卡在 INVALID_SIGNATURE 或静默失败。
怎么拿到真正能用的 .vsix 文件
不是所有“下载”按钮都等价。微软只对官网插件页右侧 Download Extension 按钮生成的链接做签名和时效校验，这个链接是临时的、带有效期、且与当前页面显示的版本严格一致。
- 打开插件市场页，例如
https://marketplace.visualstudio.com/items?itemName=ms-python.python，确保 URL 是 marketplace.visualstudio.com 域名，不是第三方镜像 - 滚动到右侧 Resources 区域，找
Download Extension按钮（新版 UI 有时藏在右上角⋯菜单里） - 点它，浏览器会直接开始下载
ms-python.python-2026.6.123456.vsix这类命名的文件——这就是你要的 - 别点
Repository或Homepage，那些跳转到 GitHub，不是下载入口
code --install-extension 总是报错？盯住这三点
命令行安装不是“有文件就能跑”，VSCode 对路径、签名、进程状态极其敏感，报错信息又极简，实际卡点非常具体：
-
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 - 装完
code --list-extensions不显示，或重启后仍不生效 → 很可能是 VSCode 进程还在后台运行（包括系统托盘里的图标）。关掉所有实例，Windows 下可任务管理器结束所有Code.exe进程
装上了却没功能？语言服务器根本没落地
很多插件（如 ms-python.python、volarjs.volar、esbenp.prettier-vscode）只装 .vsix 只是注册前端，首次启用才下载 LSP 服务（pyright-server、volar-server、prettierCLI）。离线环境卡在 “Downloading…” 就是这个原因。
- 正确做法：在有网机器上完整触发一次——打开一个
.py或.vue文件，等状态栏显示 “Ready” 后，再把整个~/.vscode/extensions/ms-python.python-2026.6.123456/目录（含子目录里的 native 二进制）拷到内网机对应路径下 - 复制完必须彻底退出 VSCode，包括右下角托盘进程，否则缓存不刷新
- ARM Mac 上装 x64 插件不会报错，只会静默丢功能；检查方法：运行
code --version看 Help → About 里显示的架构（x64/arm64），再查 .vsix 解压后package.json里是否有darwin-arm64构建标识
最常被忽略的一点：VSCode 主版本号和插件 engines.vscode 字段必须严格匹配。比如插件要求 "^1.85.0"，你用的是 1.84.x，就算 .vsix 装上了，也会在 Developer: Show Running Extensions 里看到 disabled 状态。
