报 INVALID_SIGNATURE 错误时，需加 --allow-unverified 参数绕过离线环境的微软签名验证，如 code --install-extension D:\vsix\ms-python.python.vsix --allow-unverified；该参数仅跳过签名检查，不影响版本兼容性与依赖解析。
code --install-extension 报 INVALID_SIGNATURE 怎么办
离线环境里执行 code --install-extension 时卡在 INVALID_SIGNATURE，不是文件坏了，而是 VSCode 默认要联网校验微软签名链——内网根本连不上证书服务器。
必须加 --allow-unverified 参数绕过校验：
code --install-extension D:\vsix\ms-python.python.vsix --allow-unverified- 不加这个参数，哪怕文件完全正确，也一定失败
- 该参数仅影响安装阶段，装完插件运行时不受限
下载的 .vsix 文件装了但不生效？检查三个硬依赖
插件列表里能看到名字，但功能没反应（比如 Python 插件不触发语法高亮、Prettier 不格式化），大概率是缺依赖扩展，而不是配置问题。
每个插件的 extensionDependencies 字段写死在 .vsix 解压后的 package.json 里，VSCode 不会自动提示你缺啥：
- 装
esbenp.prettier-vscode前，得先装esbenp.vscode-eslint或dbaeumer.vscode-eslint（看版本） - 装
ms-python.python必须配ms-python.pylance，否则智能提示全失效 - 装
bradlc.vscode-tailwindcss要求esbenp.prettier-vscode已存在，且版本匹配
最稳做法：在一台已联网、已配好的机器上跑 code --list-extensions --show-versions，导出完整列表再批量下载对应 .vsix。
怎么拿到真正能用的 .vsix 文件（不是 GitHub Release 那个）
从插件 GitHub 的 Releases 页面点下载，90% 概率装不上——很多项目只发源码，不打 .vsix 包；或者打了但 engines.vscode 字段没更新，导致和你的 VSCode 版本不兼容。
唯一靠谱路径是官方市场直链：
- 打开插件页，如
https://marketplace.visualstudio.com/items?itemName=ms-python.python - 右侧 Resources 区域点
Download Extension→ 浏览器直接下载带签名的临时链接 - 要下旧版本？拼 API 地址：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-python/vsextensions/python/2026.6.123456/vspackage，其中publisher、extension_name（小数点后半段）、version必须和 Version History 里一模一样
离线部署时 settings.json 同步容易被忽略
插件装好了，但中文语言包不生效、Prettier 不读配置、Python 解释器路径还是空的——这些都不是插件问题，而是用户级配置没同步。
settings.json 不在 .vsix 里，必须单独拷贝：
- Windows 路径：
%APPDATA%\Code\User\settings.json - Linux/macOS：
~/.config/Code/User/settings.json或~/Library/Application Support/Code/User/settings.json - 特别注意：
"locale": "zh-cn"这类设置如果被注释或写成"en"，中文包就白装了
工作区配置（.vscode/settings.json、launch.json）更要随项目一起放进去，离线机器不会自动生成。
