拖.vsivx进vscode没反应？先盯住这三个条件：vscode必须有系统焦点、拖入的是未解压且顶层含extension/目录的.vsix文件、vscode版本≥插件engines.vscode声明的最低版本；全屏或远程桌面会拦截拖放，需退出再试。
拖.vsivx进VSCode没反应？先盯住这三个条件
不是插件坏了，是VSCode根本没收到安装信号。拖放失败几乎全是这三点没对齐：VSCode必须有系统焦点（任务栏图标高亮）、文件必须是未解压的.vsix（用 unzip -l xxx.vsix 确认顶层含 extension/ 目录）、VSCode版本要≥插件package.json里engines.vscode声明的最低版本。全屏模式或远程桌面（RDP / TeamViewer）会拦截拖放事件，直接退出全屏再试。
code --install-extension 命令总失败？路径和签名是主因
命令行方式最可靠，但容错极低：
- 必须用绝对路径：
code --install-extension /home/user/ext/python-2024.6.0.vsix（Linux/macOS），code --install-extension C:/ext/prettier-9.10.3.vsix（Windows，推荐正斜杠） - 路径含空格或中文？必须加英文双引号：
code --install-extension "/path/to/my plugin.vsix" - 报
INVALID_SIGNATURE？离线环境无法验证证书链，加--allow-unverified参数：code --install-extension python.vsix --allow-unverified -
command not found: code？在 VSCode 里按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH启用
装上了却没功能？语言服务器根本没落地
很多插件（如 ms-python.python、volarjs.volar、esbenp.prettier-vscode）只装 .vsix 只是注册前端，首次启用才下载 LSP 服务（pyright-server、volar-server、prettierCLI）。离线环境卡在 “Downloading…” 就是这个原因。
正确做法：
- 在有网机器上完整触发一次：打开一个
.py或.vue文件，等状态栏显示 “Ready” - 把整个
~/.vscode/extensions/ms-python.python-2024.6.0/目录（含子目录里的 native 二进制）拷到内网机对应路径下 - 复制完必须彻底退出 VSCode，包括右下角托盘进程，否则缓存不刷新
ARM Mac 装 x64 插件失败？架构不匹配不报错，只丢功能
VSCode 不会提示“架构错误”，而是静默跳过加载 native 部分。检查方法：
- 运行
code --version，看 Help → About 里显示的架构（x64/arm64） - 查
.vsix解压后package.json里是否有darwin-arm64构建标识 - ARM Mac 必须用带
darwin-arm64的.vsix，尤其含 LSP server 的插件（如 Volar）
从 GitHub Release 页面下载时，别只认版本号，得盯紧平台后缀。
