离线安装vsix插件失败主因是vscode未获焦点、全屏/远程环境拦截拖放、或拖入非原始.vsix文件；命令行安装需确保code已加入path、路径为绝对路径且版本匹配package.json中engines字段。
离线安装 VSIX 插件，只要 .vsix 文件完整、VSCode 版本匹配、路径写对，基本不会失败；失败时 90% 是版本不兼容或拖放没触发——不是插件有问题，是环境没对齐。
拖进 VSCode 主窗口没反应？先确认这三件事
这是内网最常被误判为“安装失败”的场景，其实只是交互条件没满足：
- VSCode 必须已启动且获得系统焦点（任务栏图标高亮，或点击一下编辑器空白处再拖）
- 不能处于全屏模式，也不能在远程桌面（如 RDP/TeamViewer）中操作——这类环境会拦截拖放事件
- 拖进去的必须是原始未解压的
.vsix文件，不是.zip、不是解压后的文件夹、也不是浏览器自动加了双后缀（比如prettier.vsix.zip）
code --install-extension 命令总报错？重点看路径和 CLI 状态
命令行比图形界面更可靠，但前提是它真能调用到 VSCode 的安装逻辑：
-
code --version必须能返回版本号；如果提示command not found: code，说明 CLI 未注册——在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - 路径必须是绝对路径：
code --install-extension /home/user/ext/python-2024.6.0.vsix（Linux/macOS），Windows 推荐用正斜杠：code --install-extension C:/ext/ms-python.python-2024.6.0.vsix - 路径含空格或中文？必须加英文双引号：
code --install-extension "/path/to/my ext.vsix" - 报错
Extension is not compatible with Code？说明.vsix内package.json的"engines": {"vscode": "^1.85.0"}和你本地 VSCode 版本（Help → About 里看到的）不匹配
插件显示“已安装”但不生效？别重装，先查 native 依赖和启用状态
很多插件（如 ms-python.python、esbenp.prettier-vscode）安装后只是“注册”，首次激活时才会拉取语言服务器或 CLI 工具——离线环境下这一步必然卡住：
- 打开命令面板（
Ctrl+Shift+P），输入插件相关命令（如Python: Select Interpreter），看能否弹出；不能则说明没真正加载 - 查看输出面板（View → Output），切换到对应通道（如
Python或Prettier），找Failed to fetch、spawn ENOENT或Downloading...长时间不动 - 解决办法：在有网机器上先完整启用一次该插件（打开一个
.py文件，等状态栏不显示下载中），然后把整个~/.vscode/extensions/ms-python.python-2024.6.0/目录拷到离线机对应位置，而不是只拷.vsix - 检查是否被工作区禁用：左下角齿轮 → Extensions → 找到插件 → 看右上角有没有
Disable (Workspace)
最易被忽略的一点：VSCode 不会主动告诉你某个插件因版本太低而被跳过加载——它只是静默忽略。哪怕扩展列表里显示“已安装”，只要 package.json 里 "engines" 声明的最低版本高于你当前 VSCode，它就根本不会初始化。查这个，永远比重装更快。
