离线安装VSCode插件失败主因是条件不满足而非网络问题：需确保窗口获焦点、非全屏/远程桌面、拖拽原生.vsix文件；CLI需手动注册Shell Command；手动复制须解压后按ID目录名放入extensions路径并彻底重启。
离线状态下装不上插件，基本不是网络问题，而是 VSCode 没认出你给的文件、路径或版本——它对输入条件极其敏感，稍有偏差就静默失败。
拖拽安装没反应？检查这三个隐性前提
VSCode 的拖拽安装看似简单，但实际依赖三个常被忽略的状态：窗口焦点、全屏状态、文件类型。它不报错，只沉默忽略。
- VSCode 窗口必须获得系统焦点（点击编辑器任意空白处，看任务栏图标是否高亮）
- 不能处于全屏模式，也不能在远程桌面（如 RDP / TeamViewer）中操作——这类环境会拦截拖放事件
- 必须拖的是原生
.vsix文件，不是解压后的文件夹、.zip包，也不是被杀毒软件重命名的prettier.vsix.zip - 用
unzip -l prettier.vsix确认顶层目录是extension/，否则不是合法 vsix
code --install-extension 报 command not found？CLI 工具根本没注册
这不是环境变量配置失误，而是 VSCode 的 Shell Command 功能默认未启用。图形界面里点多少次都没用，必须手动触发注册流程。
- 先彻底关闭 VSCode（Windows 查任务管理器是否有残留
code.exe，macOS/Linux 运行code --status确认无进程） - 重新打开 VSCode，按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Shell Command: Install 'code' command in PATH并执行 - 重启终端，再运行
code --version验证是否返回正常版本号 - 路径含空格或中文时，必须用英文双引号包裹：
code --install-extension "/path/to/my ext.vsix"
手动复制 .vsix 到 extensions 目录为何无效？VSCode 不解压也不扫描
VSCode 从不读取 .vsix 文件本身。它只识别已解压、且目录名严格匹配扩展 ID 的子文件夹。直接复制进去等于白放。
- 先解压：
unzip your-extension.vsix -d unpacked，然后ls unpacked/看顶层目录名（如ms-python.python-2024.6.0） - 确认用户 extensions 路径：
Windows：%USERPROFILE%\AppData\Roaming\Code\Extensions\
macOS：$HOME/Library/Application Support/Code/Extensions/
Linux：$HOME/.vscode/extensions/ - 把整个
ms-python.python-2024.6.0/目录复制进去，不能只复制里面的内容，也不能保留.vsix文件 - 复制完必须彻底退出 VSCode（包括托盘进程），否则缓存不刷新，插件不会加载
批量部署时插件“装了却不见”？版本冲突和依赖缺失才是真因
执行 code --install-extension xxx.vsix 显示成功，但扩展面板里没有——大概率是 VSCode 拒绝降级，或关键依赖没一起带进来。
- 同名插件已存在且版本更高时，VSCode 默认拒绝安装，且不提示。解决办法是先删掉
~/.vscode/extensions/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\（Windows）下对应 ID 的整个文件夹 - 插件依赖不会自动拉取（如
ms-python.python依赖ms-toolsai.jupyter），必须把所有依赖项也列进清单、提前下载好.vsix - 导出清单务必加
--show-versions：code --list-extensions --show-versions > extensions.txt，否则离线安装时极易拉错版本 - 用
engines.vscode字段校验兼容性：解压任意.vsix，打开package.json，确认当前 VSCode 版本满足该字段要求，否则静默失败
最易被忽略的是：VSCode 在离线场景下几乎不报错，所有失败都表现为“没反应”或“功能不出现”。排查时别猜，要验证——焦点、路径、解压结构、进程状态、版本声明，每个环节都得亲手确认。
