离线导入VSCode插件真正卡点是engines.vscode版本不匹配、code命令未注册、语言服务器依赖缺失；拖拽需满足已加载工作区、窗口有焦点、拖原始.vsix文件；命令行安装须用绝对路径加--force，语言类插件须整目录迁移含LSP二进制。
离线导入 VSCode 插件不是“拖进去就完事”，真正卡住的往往是 engines.vscode 版本不匹配、code 命令未注册、或语言服务器依赖没带进来——这三处出错，插件会静默加载失败，连报错都不给你看。
拖拽安装没反应？先盯住这三个硬条件
很多人以为 VSCode 启动了就能拖，其实它只在特定状态响应：
- VSCode 必须已打开一个文件夹或文件（空白窗口不接收拖放）
- 主窗口要有系统焦点（任务栏图标高亮，且不能全屏/远程桌面缩放偏移）
- 拖的是原始
.vsix文件，不是.vsix.zip或解压后的文件夹
浏览器下载后自动加了 .zip 后缀？别右键重命名。用 PowerShell 执行：Copy-Item "prettier.vsix.zip" "prettier.vsix" -Force。拖进去后右下角弹出 Extensions disabled by policy？说明企业组策略锁死了扩展，GUI 和 CLI 都无效，只能走手动解压方案。
code --install-extension 报 “not compatible” 怎么查
这个错误不告诉你具体哪不兼容，得自己比对三处：
- 运行
code --version，取第一位小数点前的版本号（如1.85.2→1.85） - 用
unzip -p your.vsix extension/package.json | grep engines（Linux/macOS），或 7-Zip 打开.vsix查"vscode": "^1.80.0"—— 你本地版本必须 ≥ 这个值 - Help → About 里括号显示的架构（
x64/arm64）必须和插件构建目标一致；ARM Mac 装 x64 插件会卡在 native 二进制加载
Windows 下路径含空格？必须加英文双引号：code --install-extension "C:\my ext\python.vsix"。提示 command not found: code？说明 CLI 没注册：按 Ctrl+Shift+P，输入并执行 Shell Command: Install 'code' command in PATH。
插件装上了但 Python/Prettier 不工作？LSP 依赖没离线到位
像 ms-python.python、dbaeumer.vscode-eslint 这类插件，安装只是注册，首次启用才下载 pyright、eslint-cli 等二进制依赖——离线环境会卡在状态栏 Downloading... 或 Output 面板报 spawn ENOENT。
- 正确做法：在有网机器上完整跑一遍——打开一个
.py文件 → 等状态栏不显示Downloading→ 再去%USERPROFILE%\.vscode\extensions\（Windows）或$HOME/.vscode/extensions/（macOS/Linux）里整个拷对应文件夹（如ms-python.python-2024.6.0/） - 不能只拷
.vsix，也不能漏掉node_modules或子目录里的pyright-server - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新
手动解压复制到 extensions 目录的细节陷阱
这是绕过签名验证的最后手段，但“复制粘贴”不等于“能用”：
- 先用
unzip -l your.vsix查顶层目录名，例如esbenp.prettier-vscode-9.10.3/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 解压后整个文件夹（含
package.json、node_modules）移入%USERPROFILE%\.vscode\extensions\（Windows）或$HOME/.vscode/extensions/（macOS/Linux） - 不能只放
.vsix文件进去，也不能丢掉外层目录直接拷内容；否则 VSCode 启动时识别不到，日志里只显示Extension 'xxx' is not installed
最易被忽略的一点：离线环境下，code --install-extension 默认仍会尝试联网校验签名。若网络不通，它可能卡住或静默失败——加 --force 参数跳过“已存在”检查，是批量部署时的实际必需项。
