VSCode怎么离线安装VSIX插件包-VSCode-PHP中文网

离线安装vscode插件成功的关键是确保.vsix文件的版本、签名、平台三者全对；须通过官方市场“download extension”按钮或api直链下载，安装时加--allow-unverified参数、关闭所有vscode实例、使用纯英文路径，并在联网环境预触发语言服务器后整目录迁移。

vscode怎么离线安装vsix插件包

离线安装 VSCode 插件，核心不是“怎么点”，而是“怎么确保装进去的那个 .vsix 文件，版本、签名、平台三者全对”。错一个，就会卡在 INVALID_SIGNATURE、Extensions compatibility is not supported 或装完不生效。

别信浏览器下载记录里那个自动命名的文件——它可能被重定向成 HTML 错误页，也可能来自第三方镜像（比如 open-vsx.org），和官方市场签名不一致。唯一稳的路径是走微软官方直链：

打开插件页，例如 https://marketplace.visualstudio.com/items?itemName=ms-python.python
点右侧 Resources → Download Extension，这个按钮生成的是带有效期签名的临时 URL，版本、平台、签名三者全对
如需历史版本或批量下载，用 API 拼：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-win32-x64.vsix，避免在 Windows 上误装 darwin-arm64 版

命令行安装不是“有文件就能跑”，VSCode 对路径、签名、进程状态极其敏感：

VSCode

避免常见的 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-2026.6.123456-win32-x64.vsix --allow-unverified
装完 code --list-extensions 不显示，或重启后仍不生效：大概率 VSCode 进程还在后台运行。关掉所有实例（包括系统托盘里的），Windows 下可任务管理器结束所有 Code.exe 进程
路径含中文或空格（如 C:\用户\张三\vsix\python.vsix）会静默失败，务必移到纯英文路径，例如 C:\vsix\python.vsix，且 Windows 下推荐用正斜杠：code --install-extension "C:/vsix/python.vsix"

像 ms-python.python、esbenp.prettier-vscode 这类插件，.vsix 只是外壳，首次激活时会联网下载 pyright、prettier 等语言服务二进制。离线环境里，这步直接卡死。

解决办法：先在有网环境打开一次该插件（比如打开一个 .py 文件触发 Python 扩展），让它把依赖下全；再整目录打包迁移：%USERPROFILE%\.vscode\extensions\ms-python.python-2026.6.123456 整个文件夹拷到内网机对应路径
或者，提前在联网机上用 code --install-extension 安装，再从扩展目录里把已解压的文件夹复制过去，比单纯拷 .vsix 更可靠
注意：扩展目录里每个插件文件夹名含版本号，手动复制时别漏掉这个后缀，否则 VSCode 识别为未安装

最常被忽略的一点：VSIX 文件本质是 ZIP 包，你可以直接改后缀解压开看 package.json 里的 engines.vscode 字段——它声明了最低支持的 VSCode 版本。如果你内网的 VSCode 是 1.85，而 .vsix 要求 1.90，再怎么绕过签名也白搭。