拖.vsix进VSCode没反应，根本不是插件问题，而是VSCode对拖放事件极其敏感，需同时满足三条件：窗口有系统焦点、未全屏或远程桌面、拖入的是原生未解压的.vsix文件（unzip -l验证顶层含extension/目录）；code命令报错需先注册CLI并用绝对路径；功能不显多因LSP未离线部署；ARM Mac须严格匹配darwin-arm64架构。
拖.vsix进VSCode没反应，根本不是插件问题
VSCode 对拖放事件极其敏感，不满足任一隐性条件就静默忽略，连错误提示都不给。常见卡点有三个：VSCode 窗口没系统焦点（任务栏图标未高亮）、处于全屏或远程桌面（RDP/TeamViewer 会拦截拖放事件）、拖的是解压后的文件夹或被杀毒软件改名的 .vsix.zip。验证是否为原生 .vsix：在终端运行 unzip -l your-ext.vsix，输出第一行必须是 extension/ 目录。
code --install-extension 命令失败的真正原因
报 command not found: code 不是网络问题，是 CLI 工具根本没注册到系统路径。必须在 VSCode 图形界面中按 Ctrl+Shift+P 输入 Shell Command: Install 'code' command in PATH 手动启用，且需重启终端生效。即使命令可用，也只认绝对路径：code --install-extension /home/user/ext/volarjs.volar-1.12.0.vsix；相对路径、含空格或中文的路径必须加英文双引号包裹。
插件显示已安装但功能不出现，LSP 服务才是关键
很多插件（如 ms-python.python、volarjs.volar）只装 .vsix 是注册前端，首次启用才下载语言服务器（pyright-server、volar-server）。离线环境会卡在 “Downloading…” 状态栏不动。正确做法：在有网机器上打开一个对应文件（如 .py 或 .vue），等状态栏显示 “Ready” 后，完整拷贝整个扩展目录（如 ~/.vscode/extensions/ms-python.python-2024.6.0/）到内网机相同路径，并彻底退出 VSCode（包括托盘进程），否则缓存不刷新。
ARM Mac 装 x64 插件失败却无提示，架构错配是静默杀手
VSCode 不会报 “架构不匹配” 错误，而是直接跳过加载 native 二进制部分，导致功能残缺。检查方法：运行 code --version 看 Help → About 中的架构标识（x64 / arm64）；再解压 .vsix 查 package.json 里是否有 darwin-arm64 构建字段。ARM Mac 必须用带 darwin-arm64 后缀的版本，尤其对含 LSP server 的插件——GitHub Release 页面下载时，不能只看版本号，得盯紧平台后缀。
