拖拽.vsix到编辑区是最稳的安装方式：需VSCode已启动且有焦点、加载工作区，直接拖未解压.vsix包至编辑区触发安装；失败常因窗口无焦点、全屏、远程连接拦截、文件非原始压缩包或版本不兼容。
拖拽 .vsix 到编辑区是最稳的安装方式
VSCode 已启动、有焦点、加载了任意工作区（哪怕空文件夹），把未解压的 .vsix 文件直接拖进代码编辑区域（不是侧边栏、不是设置页），松手就会弹出安装确认框。它不走网络、不校验签名、不依赖 code CLI 是否可用，是离线环境下成功率最高的路径。
常见失败原因全是“看似没反应”，其实只是条件没对齐：
- VSCode 窗口没获得系统焦点（任务栏图标未高亮）
- 处于全屏模式，或通过 RDP / TeamViewer 远程连接（这类环境常拦截拖放事件）
- 拖的是解压后的文件夹，或重命名成
.zip的文件（.vsix必须保持原始压缩包形态） - 插件版本与当前 VSCode 不兼容（例如插件要求
"vscode": "^1.85.0"，而你用的是 1.82.3）
code --install-extension 命令必须用绝对路径
该命令适合批量部署或写脚本，但它对路径极其敏感，相对路径几乎必败。
Windows 下推荐统一用正斜杠，避免反斜杠转义问题：code --install-extension C:/ext/ms-python.python-2024.6.0.vsix
路径含空格或中文？必须加英文双引号：code --install-extension "D:/my ext/pretter-9.10.3.vsix"
如果提示 command not found: code，说明 CLI 未注册到 PATH——在 VSCode 中按 Ctrl+Shift+P 输入 Shell Command: Install 'code' command in PATH 启用即可。
手动解压复制到 extensions 目录是底层硬核方案
当 GUI 被组策略禁用、CLI 不可用、或需部署含 native binary（如 pyright、esbuild）的插件时，只能拆包直装。
关键不是“复制进去”，而是“结构还原”：
- 先用
unzip -l your-extension.vsix查顶层目录名，例如ms-python.python-2024.6.0/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 解压后，把整个该目录（含
package.json、node_modules等）复制进：
Windows：%USERPROFILE%\AppData\Roaming\Code\Extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 不能只复制里面的内容，也不能保留
.vsix文件本身 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新，新插件不会加载
插件显示已安装却没功能？重点查三处
VSCode 对版本不兼容、LSP 下载失败、权限策略拦截的处理非常安静：不报错、不提示、只是跳过激活。
验证是否真能用，别只看扩展面板：
- 打开命令面板（
Ctrl+Shift+P），输入插件相关命令（如Python: Select Interpreter），看能否调出 - 查看输出面板（
View → Output），切换到对应插件通道（如Python、Prettier），找Failed to fetch或spawn ENOENT - 语言类插件首次启用会尝试下载 LSP 服务，离线时卡在 “Downloading…” —— 需提前准备带 LSP 二进制的完整
.vsix，或改用预编译版（如pyright的darwin-arm64构建）
最易被忽略的是版本锁：打开解压后的 package.json，检查 "engines": {"vscode": "^1.85.0"}，再运行 code --version，取第一位小数点前的数字（如 1.85.2 → 1.85），必须 ≥ 插件声明的最低版本。
