code --install-extension 报错无输出，90% 是 code 命令未加入 path；拖拽 .vsix 无效多因无工作区、窗口失焦或文件非原始 vsix；插件装上不工作常因 lsp 服务未下载；兼容性错误主因 vscode 版本或架构不匹配。
code --install-extension 报错但没输出？先确认 CLI 是否真可用
命令行安装静默失败，90% 是 code 命令根本没进系统 PATH，不是插件问题。VSCode 官方 .deb/.rpm 包和 macOS ZIP 版默认不注册 CLI，尤其在 SSH、WSL 或非交互式终端里更常见。
实操建议：
- 运行
which code（Linux/macOS）或where code（PowerShell），无输出就说明不可用 - 临时解决：用绝对路径，如
/usr/bin/code --install-extension /path/to/xxx.vsix（Ubuntu）或/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code --install-extension /path/to/xxx.vsix（macOS） - 永久修复：在 VSCode 里按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux）→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 → 重启终端 - 别加
sudo：否则插件会装到 root 用户目录，普通用户启动 VSCode 后看不到
拖拽 .vsix 没反应？检查窗口状态和文件完整性
图形界面拖放依赖后台调度和签名验证，断网时它不报错，只挂起或丢弃操作。这不是 UI bug，而是三个前提缺一不可。
实操建议：
- VSCode 必须已加载一个工作区（哪怕只是空文件夹），纯启动页或远程连接未建立时，拖放事件被忽略
- 窗口要有系统焦点：任务栏图标高亮，且不能处于全屏、RDP、TeamViewer 或多显示器缩放偏移状态
- 拖的是原始
.vsix文件，不是解压后的文件夹、不是.zip、不是右键重命名生成的xxx.vsix.zip（Windows 会静默解压） - 验证方法：
unzip -l your-extension.vsix应显示顶层为extension/目录，且含extension/package.json
装上了但 Python/C++/Vue 不工作？LSP 服务根本没落地
像 ms-python.python、ms-vscode.cpptools、Vue Language Features (Volar) 这类插件，.vsix 只是前端壳。真正干活的语言服务器（如 pyright-server、clangd、volar-server）需首次启用时联网下载。离线环境下，它就卡在 “Downloading…” 或直接跳过。
实操建议：
- 在有网机器上完整触发一次：打开一个
.py文件 → 等状态栏不再显示 “Downloading” → 再去$HOME/.vscode/extensions/（Linux/macOS）或%USERPROFILE%\.vscode\extensions\（Windows）里整个拷对应文件夹（如ms-python.python-2024.6.0/） - 不能只拷
.vsix，也不能只拷node_modules；native 二进制（如pyright-server）藏在子目录里，漏一个就启动失败 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新
“Extension is not compatible” 或 “corrupt”？版本和架构才是关键
这类错误几乎从不因文件损坏，而是 package.json 中的 engines.vscode 字段与本地版本不匹配，或 ARM 架构机器装了 x64 构建的包。
实操建议：
- 运行
code --version，取前两位（如1.92.2→1.92） - 解压
.vsix：unzip -p plugin.vsix extension/package.json | grep engines，看"vscode": "^1.85.0"这类字段 - 本地版本必须 ≥ 插件要求的最低版本；差一个小版本（如
1.92vs^1.93.0）就会静默拒绝 - Help → About 里看架构（
x64/arm64），ARM Mac 装 x64 构建的.vsix会功能缺失，不是报错 - 别手动改
package.json并重打包：绕过签名后插件可能被禁用，或 LSP 启动失败
.vsix 自动带入，必须提前在有网环境完整触发并整目录迁移。
