最稳路径是拖.vsix进主编辑区；失败主因是VSCode缺焦点、文件非原始.vsix或版本不兼容——需确认窗口高亮、非全屏/远程环境、顶层为extension/目录，且拖至中间白色区域。
离线安装 VSCode 插件，最稳路径是拖 .vsix 文件进主编辑区；但若失败，90% 是因为 VSCode 没焦点、文件被解压、或版本不兼容——不是方法错了，是条件没对齐。
拖 .vsix 进 VSCode 主窗口为什么没反应
这是离线安装里最高频的“假失败”，VSCode 不报错也不提示，只是静默忽略。关键检查点：
- VSCode 必须正在运行且获得系统焦点（任务栏图标高亮，不是灰的）
- 不能处于全屏状态，也不能在远程桌面（RDP/TeamViewer）中——这类环境常拦截拖放事件
- 拖进去的必须是原始
.vsix文件，不是解压后的文件夹，也不是重命名成.zip的包（可用unzip -l xxx.vsix看顶层是否为extension/目录） - 必须拖到主编辑区（中间白色区域），拖到侧边栏、设置页、终端面板或扩展面板空白处都无效
code --install-extension 命令总失败的三个硬坑
命令行看似干净利落，但实际卡点非常具体，失败时往往只输出一行错误，根本看不出哪错了：
-
code命令不可用？不是 PATH 问题，而是 VSCode 没启用 Shell Command：按Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - 路径必须用绝对路径：
code --install-extension /home/user/ext/prettier-9.10.3.vsix（Linux/macOS）或code --install-extension C:/ext/ms-python.python-2024.6.0.vsix（Windows，推荐正斜杠）；相对路径在非 VSCode 启动的终端中极易失效 - 离线环境下证书链无法验证，会卡在
INVALID_SIGNATURE：加--allow-unverified参数，例如code --install-extension python.vsix --allow-unverified
装上了插件却没功能？先查 package.json 里的 engines.vscode
VSCode 对不兼容插件的处理极其安静：不报错、不提示、只是跳过加载。真正生效前必须确认三件事：
- 打开
.vsix文件（它本质是 zip），解压后读package.json，找"engines": {"vscode": "^1.85.0"}字段 - 运行
code --version，取输出中前两位（如1.84.2→1.84），必须 ≥ 插件要求的最低版本 - ARM Mac 上装 x64 构建的插件（尤其含 native binary 的，如
volar-server）会彻底失效；得确认下载的是带darwin-arm64的版本
手动复制到 extensions 目录的底层操作要点
适用于无 GUI、纯终端服务器或 CLI 完全不可用的场景，但容错率低，每一步都必须精准：
- 先解压
.vsix，看顶层目录名，例如esbenp.prettier-vscode-9.10.3/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 不能只复制里面的内容，也不能把
.vsix文件本身放进去；正确路径是：
Windows：%USERPROFILE%\AppData\Roaming\Code\Extensions\
Linux/macOS：$HOME/.vscode/extensions/ - 复制完必须彻底退出 VSCode，包括右下角托盘进程；否则缓存不刷新，新插件不会加载
复杂点不在安装动作本身，而在于插件是否真正“活”起来——比如 Volar 装完没语法高亮，大概率是 server/ 目录下缺 volar-server 二进制；Python 插件没智能提示，可能漏装了 ms-python.pylance。离线部署时，别信“已安装”，要看 Developer: Show Running Extensions 里有没有它在跑。
