离线安装vscode插件最稳方式是拖拽未解压.vsix到主编辑区，需vscode已启动并加载工作区、有焦点、非全屏/远程状态；安装后默认禁用，须手动启用或重启，语言插件首次启用会离线卡在lsp下载。
离线安装 VSCode 插件，只要 .vsix 文件完整、VSCode 版本匹配、路径写对，就能成功——它不是“退而求其次”，而是 VSCode 官方明确支持的标准流程。
拖拽 .vsix 到主编辑区是最稳的安装方式
VSCode 已启动且加载了任意工作区（哪怕只是空文件夹）时，把未解压的 .vsix 文件直接拖进代码编辑区域（不是侧边栏、不是设置页），松手就会弹出安装确认框。这是离线环境下成功率最高、不依赖 CLI、不触发任何网络请求的方式。
- 如果拖进去没反应，先检查右下角状态栏是否显示
Extensions disabled by policy—— 企业组策略可能已全局禁用扩展安装 - 确保 VSCode 窗口有焦点，且没处于全屏、远程 SSH 连接未就绪、或多显示器缩放偏移状态
- 安装完成后插件默认是禁用状态，需手动点「启用」或重启 VSCode；语言类插件（如
ms-python.python）首次启用还会尝试下载 LSP 服务，离线会卡在“Downloading…”
code --install-extension 命令必须用绝对路径
该命令适合批量部署、脚本化或排障，但它不会自动帮你修复 PATH 或校验版本，报错即意味着问题明确可查。
- Windows 下路径含空格必须加双引号：
code --install-extension "C:\ext\prettier-3.2.5.vsix" - Linux/macOS 必须用绝对路径：
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 都被策略封锁，或需要部署带 native 二进制的插件（如 pyright、esbuild）时，只能拆包直装。但这不是简单复制粘贴，而是严格还原目录结构。
- 先用
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（包括托盘进程），再重新打开
验证插件是否真能用，别只看扩展面板
VSCode 扩展面板里显示“已安装”，不代表能用。有些插件需要重启工作区，有些要打开特定文件类型才激活，还有些会静默失败。
- 打开命令面板（
Ctrl+Shift+P），输入插件相关命令（如Python: Select Interpreter），看能否调出 - 检查输出面板（
View → Output），切换到对应插件名称的通道（如Python、Prettier），看有没有报Failed to fetch或spawn ENOENT - 语言服务器类插件（如
rust-analyzer、pylsp）安装后需重启对应工作区（不是整个 VSCode）才能加载 LSP
最常被忽略的是：插件声明的 "engines": {"vscode": "^1.80.0"} 和你本地 code --version 输出的版本号是否真正兼容——VSCode 不报错，但会跳过加载，连日志都不留。这点必须手动核对，不能只信“已安装”状态。
