VSCode 可直接拖拽 .vsix 文件到主编辑区安装，但需确保来源可信、版本兼容（核对 engines.vscode、架构、平台）、未被策略禁用；失败时检查右下角提示、命令行安装 code --install-extension 及离线依赖。
VSCode 怎么用本地 .vsix 文件安装插件
直接拖进 VSCode 窗口就能装，但得确保文件来源可信、VSCode 版本兼容，且没被策略禁用。
常见错误现象：Unable to install extension ... because it is not compatible with the current version of VS Code，或拖进去后毫无反应——多半是版本不匹配，或 VSCode 正在以受限模式（比如企业策略锁死扩展安装）运行。
- 打开 VSCode，把
.vsix文件直接拖到编辑器区域（不是侧边栏，不是设置页，就是你写代码的主窗口） - 松手后弹出确认框，点 Install；如果没反应，检查右下角状态栏是否有“Extensions disabled by policy”提示
- 安装完需重启对应工作区（不是整个 VSCode），尤其是语言服务器类插件（如
rust-analyzer、pylsp）
离线安装前必须核对的三个兼容性条件
VSIX 不是“扔进去就跑”，它自带元数据，VSCode 会在安装时校验三件事：VSCode 主版本号、目标架构（x64/arm64）、是否声明支持当前平台（Windows/macOS/Linux）。
典型报错：This extension is not available in your region 或静默失败——其实和区域无关，是 engines.vscode 字段不满足。
- 用
unzip -p xxx.vsix extension/package.json | grep engines（Linux/macOS）或 7-Zip 打开.vsix查看package.json中的"engines": {"vscode": "^1.80.0"} - 运行
code --version，取第一位小数点前的数字（如1.85.2→1.85），需 ≥ 插件要求的最低版本 - ARM Mac 装 x64 编译的插件（尤其含 native binary 的，如
esbuild相关）会失败，此时需找带darwin-arm64构建的 vsix
命令行安装 .vsix 的可靠方式（适合批量或 CI 场景）
GUI 拖拽方便，但脚本化、远程部署或无图形界面时，必须用 code --install-extension 命令，它比 GUI 更早暴露兼容性问题。
注意：该命令依赖 VSCode CLI 工具，首次使用需先在 VSCode 里按 Ctrl+Shift+P 运行 Shell Command: Install 'code' command in PATH。
- 安装单个：
code --install-extension /path/to/extension.vsix - 静默安装（跳过确认）：
code --install-extension /path/to/extension.vsix --force（--force会覆盖同名旧版） - 验证是否装上：
code --list-extensions | grep publisher.name，别只信输出文字，有些插件注册了但没激活
装完插件不生效？重点查这三处
离线安装最大的认知偏差是：“装上 = 能用”。实际上，很多插件依赖网络初始化（比如下载 language server 二进制、拉取 schema、校验 license），离线环境会卡在激活环节。
典型表现：插件出现在已安装列表，但语法高亮/补全/格式化全无响应，开发者工具（Ctrl+Shift+U）里看到 Extension host terminated unexpectedly。
- 打开命令面板（
Ctrl+Shift+P），搜Developer: Toggle Developer Tools，看 Console 里是否有Failed to fetch或ENOTFOUND - 检查插件文档是否要求额外下载运行时（如
prettier插件需本地有prettiernpm 包，clangd插件需手动放clangd二进制到 PATH） - 某些插件（如
GitLens）离线时会禁用部分功能但不报错，需手动进设置搜gitlens.advanced.git看是否 fallback 到内置 git
