拖拽.vsix到编辑区是最稳的安装方式：需VSCode已启动、有系统焦点、已加载任意工作区（含空文件夹），且拖入原始未解压.vsix文件；缺一即无反应。
拖拽.vsix到编辑区是最稳的安装方式
内网机器上 VSCode 已启动、有焦点、且打开了任意工作区（哪怕空文件夹），直接把未解压的 .vsix 文件拖进代码编辑区域，松手就会弹出安装确认框。它不走网络、不校验签名、不依赖 code CLI 是否注册，是离线环境下成功率最高的路径。
常见“没反应”其实只是条件没对齐：
- VSCode 窗口没获得系统焦点（任务栏图标未高亮）
- 处于全屏模式，或通过 RDP / TeamViewer 远程连接（这类环境常拦截拖放事件）
- 拖的是解压后的文件夹，或重命名成
.zip的文件（.vsix必须保持原始压缩包形态） - 插件版本与当前 VSCode 不兼容（例如插件声明
"engines": {"vscode": "^1.85.0"}，而你用的是 1.82.3）
code --install-extension 命令行安装要点
适合批量部署或写脚本，但它对路径极其敏感，相对路径几乎必败。
- Windows 下推荐统一用正斜杠：
code --install-extension C:/ext/ms-python.python-2024.6.0.vsix - 路径含空格或中文？必须加英文双引号：
code --install-extension "D:/my ext/prettier-9.10.3.vsix" - 如果提示
command not found: code，说明 CLI 未注册到 PATH——在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH启用即可 - 安装后不重启 VSCode，新插件不会加载（右下角托盘进程也得彻底退出）
手动解压复制到 extensions 目录是底层硬核方案
当 GUI 被组策略禁用、CLI 不可用、或需部署含 native binary（如 pyright、esbuild）的插件时，只能拆包直装。
- 先用
unzip -l your-extension.vsix查顶层目录名，例如ms-python.python-2024.6.0/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 解压后，把整个该目录（含
package.json、node_modules等）复制进：
Windows：%USERPROFILE%\AppData\Roaming\Code\Extensions\
macOS/Linux：$HOME/.vscode/extensions/ - 不能只复制里面的内容，也不能保留
.vsix文件本身 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新
AI 类插件装完就灰着？大概率是 endpoint 没改
插件装上了不代表能调模型。绝大多数 AI 插件（如 CodeGeeX、Tabby、Continue）默认 endpoint 指向公网地址，内网根本请求不出去。装完后功能不可用，不是插件没装好，而是配置还卡在默认值上。
- 关键三件套：Base URL、API Key、Model ID 都得指向一个内网可达的通道（比如 TaoToken）
- Base URL 不能写错格式，常见错误是漏掉
/v1后缀，或写成https://taotoken.net（缺路径）而不是https://taotoken.net/v1 - API Key 不能硬编码在
settings.json里，尤其不能提交到 Git；建议用环境变量或本地配置文件隔离 - 验证是否生效：触发一次真实补全（比如 Ctrl+Enter），看输出日志里请求发到了哪个地址、返回是 401 还是 connection timeout
真正容易被忽略的是「插件版本和 VSCode 版本的隐式兼容性」：很多插件在 package.json 里声明了最低支持的 VSCode 版本，但错误提示往往只说 Extension is not compatible with Code，不告诉你具体差哪一版。遇到这种情况，别急着升级 VSCode，先查插件的历史版本页，下个匹配的旧版 .vsix 更快。
