离线安装VS Code插件最稳方式是拖拽.vsix到主窗口，需VS Code运行且有工作区；失败主因是版本不匹配或依赖缺失，CLI安装需绝对路径，手动解压须严格保持目录结构。
离线安装 VS Code 插件，只要 .vsix 文件来源可信、版本匹配、路径正确，就能成功——它不是临时补救，而是 VS Code 官方支持的标准流程，但失败几乎都卡在版本校验或依赖缺失上。
拖拽 .vsix 到主窗口是最稳的离线安装方式
VS Code 正在运行且已加载一个工作区（哪怕只是空文件夹）时，把未解压的 .vsix 文件直接拖进编辑器主区域（不是侧边栏、不是设置页），松手即弹出安装确认框。这是成功率最高、不依赖 CLI、不触发网络请求的方式。
- 没反应？先检查右下角状态栏是否显示
Extensions disabled by policy—— 企业策略禁用时，拖拽和命令行都会失效 - 确保 VSCode 有焦点，且未处于全屏、远程 SSH 连接未就绪、或多显示器缩放偏移状态
- 安装后插件默认禁用，需手动点「启用」或重启 VSCode；语言类插件（如
ms-python.python）首次启用还会尝试下载 LSP 服务，离线会卡在“Downloading…”
code --install-extension 命令必须用绝对路径且 CLI 已注册
该命令是批量部署、脚本化或排障时最可靠的入口，但它不会自动帮你修复 PATH 或校验版本，报错即意味着问题明确可查。
- Windows 下路径含空格必须加双引号：
code --install-extension "C:\ext\prettier-3.2.5.vsix" - macOS/Linux 必须用绝对路径：
code --install-extension /opt/vscode-ext/esbenp.prettier-vscode-9.10.3.vsix - 若提示
command not found: code，说明 CLI 未注册：在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - 静默安装并覆盖旧版可用
--force参数：code --install-extension xxx.vsix --force
手动解压 .vsix 放入 extensions 目录是绕过签名验证的应急方案
当组策略彻底封锁 GUI 和 CLI 安装时，只能拆包直装。但这不是“复制粘贴”，而是严格还原 VS Code 的目录结构，否则插件根本不会被识别。
- 先用
unzip -l your-extension.vsix查顶层目录名，例如ms-python.python-2024.6.0/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 解压后整个文件夹（含
package.json、node_modules等）移入对应 extensions 路径：
Windows：%USERPROFILE%\.vscode\extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 不能只放
.vsix文件进去，也不能丢掉外层目录直接拷内容；复制完需完全退出 VSCode（包括托盘进程），再重新打开 - 部分含 native 二进制的插件（如
rust-lang.rust-analyzer）在 ARM Mac 上若用了 x64 构建版，会静默失败，需确认.vsix内含darwin-arm64构建产物
离线安装失败，90% 是因为 engines.vscode 版本不匹配
VS Code 安装时会严格比对 .vsix 包内 extension/package.json 的 "engines": {"vscode": "^1.80.0"} 字段与本地版本（code --version 输出如 1.85.2，取前两位 1.85）。不满足则报 Extension is not compatible with Code，且不提示具体兼容范围。
- 快速验证：用
unzip -p xxx.vsix extension/package.json | grep engines（macOS/Linux）或 7-Zip 打开查看package.json - 若本地是
1.72.0，而插件要求^1.75.0，安装会跳过或报错；此时需降级插件或升级 VS Code - ARM Mac 用户尤其注意：x64 编译的
.vsix（尤其含esbuild、pyright的）在arm64架构下无法运行，必须找带darwin-arm64标识的版本 - 下载地址务必来自官方市场页面右上角
Download Extension按钮，而非第三方打包或浏览器误改后缀（如.vsix.zip）
真正麻烦的从来不是“怎么装”，而是装完后语言服务器不动、格式化不生效、补全无响应——那大概率是插件依赖的 LSP 或 CLI 工具没在离线前完整拉下来。所以离线部署前，最好先在有网机器上打开对应文件类型，等状态栏变绿、输出面板无报错，再把整个 extensions/xxx-yyy.zzz 文件夹拷过去。
