离线安装VSCode插件失败主因是下载源不可靠、路径错误、版本不匹配或依赖缺失；需从官方市场点击“Download Extension”或手拼带签名直链下载.vsix，用unzip -t校验完整性，确保VSCode已开工作区且聚焦，用code --install-extension安装时注意路径引号、版本兼容及依赖扩展。
离线安装 VSCode 插件失败，八成不是操作错了，而是卡在下载源不可靠、路径不对、版本不匹配或依赖没带全这四点上。直接拖 vsix 文件进 VSCode 窗口“没反应”，大概率是 VSCode 没焦点、没开工作区，或者文件本身已损坏。
怎么确保下载的 .vsix 文件能用
别信第三方镜像站或聚合页（比如 vsix.2i.gs），它们不校验签名，也不同步更新，装的时候常报 This extension may have been tampered with 或静默失败。最稳方式只有两种：
- 在官方插件页（如
https://marketplace.visualstudio.com/items?itemName=ms-python.python）点右侧 “Download Extension” 按钮——这个链接带服务端签名，只对未安装过的插件显示；若按钮消失，开无痕窗口 + 登出 Marketplace 账号再试 - 手拼直链：
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/{publisher}/vsextensions/{extension_name}/{version}/vspackage，三个字段必须严格匹配：publisher（右上角 “Publisher” 后 ID，如ms-python）、extension_name（ms-python.python中小数点后半段，即python）、version（从 “Version History” 复制完整版本号，如2024.6.0，少一位都 404）
下载后务必校验完整性：unzip -t your-plugin.vsix（Linux/macOS）或用 PowerShell 执行 Copy-Item "old.zip" "new.vsix" -Force（Windows 不要用右键重命名，会破坏 ZIP 头）。
code --install-extension 命令总失败？先查这三件事
报 command not found: code？不是 PATH 问题，是 VSCode 没启用 Shell Command：按 Ctrl+Shift+P → 输入 Shell Command: Install 'code' command in PATH → 回车执行。
- 报
ENOENT或没反应？路径必须是绝对路径，且含空格/中文时得加英文双引号：code --install-extension "/path/to/my ext.vsix" - 报
Extension is not compatible with Code？不是 VSCode 太旧，而是.vsix解压后extension/package.json里"engines": {"vscode": "^1.85.0"}要求 ≥ 1.85，而你本地是code --version输出的1.84.2—— 这种不兼容 VSCode 不提示，只是跳过加载 - 装完不生效？插件可能依赖其他扩展（如
ms-python.python强依赖ms-python.pylance），--list-extensions看不到不代表装成功，得重启 VSCode 后查Developer: Show Running Extensions
拖 vsix 进 VSCode 窗口没反应？检查运行态条件
拖放安装看似简单，但只在三个条件同时满足时才触发：
- VSCode 必须已获得系统焦点（任务栏图标高亮）
- 必须已打开工作区（即至少打开了一个文件夹或文件），纯空白启动窗口不响应拖拽
- 拖入目标是编辑器主区域（代码显示区），不是侧边栏、设置页、扩展面板本身
全屏模式或远程桌面（RDP / TeamViewer）常拦截拖放事件，此时改用命令行或手动解压方式更可靠。
内网批量部署时最容易漏掉的关键点
单个插件手动装没问题，但团队批量部署时，人肉下载极容易漏掉隐式依赖 —— 比如装了 esbenp.prettier-vscode 却没装 bradlc.vscode-tailwindcss，格式化功能就直接失效。别信插件页写的 “Recommended”，那是推荐栏，不是依赖树。
- 最稳做法：在已配好的联网机器上导出完整列表：
code --list-extensions > extensions.txt，然后逐行用vsce download ms-python.python@2024.6.0下载对应 vsix - 语言类插件（如
MS-CEINTL.vscode-language-pack-zh-hans）的 publisher 是MS-CEINTL（全大写），错写成ms-ceintl就 404 或下载损坏 - 含 native binary 的插件（如 Python/Rust/Go 插件）首次启用时还会外网下载 LSP 服务器（pyright、rust-analyzer 等），离线环境需提前在同版本 VSCode 上触发一次下载，再把缓存目录打包过去
真正麻烦的从来不是下载或安装动作本身，而是插件声明的 engines.vscode 版本、依赖扩展的显式/隐式关系、以及 native 工具链的离线补全 —— 这三块不提前对齐，装完就是“已安装但没功能”。
