离线安装vscode插件失败主因是隐性条件未满足：vscode缺焦点、拖入非原生.vsix文件、路径非绝对、cli未注册、版本不兼容或手动复制未解压目录；装后不生效常因禁用、依赖缺失或lsp未预加载。
离线安装 VSCode 插件失败，90% 不是操作错了，而是某个隐性条件没对上——比如 VSCode 没焦点、vsix 被解压过、路径用了相对地址，或者版本声明不匹配。
拖进主窗口没反应？先确认这三件事
这是离线安装里最高频的“假失败”，VSCode 静默忽略拖放，不报错也不提示。
- VSCode 窗口没获得系统焦点：点击编辑器任意空白处，看任务栏图标是否高亮，再试
- 当前处于全屏模式或远程桌面（如 RDP / TeamViewer）：这类环境常拦截拖放事件，退出全屏或改用
code --install-extension - 拖的是解压后的文件夹、
.zip或被杀毒软件重命名的prettier.vsix.zip：用unzip -l prettier.vsix看顶层是否为extension/目录
code --install-extension 报错或无反应？路径和注册是关键
命令行看似简单，但卡点几乎全在路径和 CLI 注册上，跟网络完全无关。
-
command not found: code：不是 PATH 问题，而是 VSCode 没启用 Shell Command——打开 VSCode →Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 路径必须是绝对路径：
./python.vsix在脚本中大概率失效；Windows 推荐用正斜杠C:/ext/ms-python.python-2024.6.0.vsix，Linux/macOS 用/home/user/ext/prettier.vsix - 路径含空格或中文：必须加英文双引号，例如
"C:/my ext/python.vsix"
手动复制 .vsix 到 extensions 目录为什么无效
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（包括右下角托盘进程），否则缓存不刷新
插件显示已安装但功能不出现？别急着重装，先查兼容性
VSCode 对版本不兼容的处理非常安静：不报错、不提示、只是跳过加载。装上了≠能用。
- 打开
.vsix（本质是 zip），解压后查package.json中的"engines": {"vscode": "^1.85.0"} - 运行
code --version，取输出第一位小数点前的数字（如1.90.2→1.90），需 ≥ 插件要求的最低版本 - ARM Mac 上装 x64 构建的插件（尤其含 native binary 的）会失败，得找带
darwin-arm64的 vsix - 插件可能依赖其他扩展（如
ms-python.python强依赖ms-python.pylance），--list-extensions看不到不代表装成功，得重启后查Developer: Show Running Extensions
最易被忽略的一点：离线环境里，插件装完默认是禁用状态，必须手动点「启用」或重启 VSCode 才生效——这个动作没有视觉反馈，很容易以为已经好了。
