离线更新vscode插件须用已验证.vsix文件拖拽至编辑器中央安装，确保语言服务器、架构、版本匹配；手动复制需严格遵循目录命名规则并彻底退出vscode。
离线环境下更新 VSCode 插件，不能依赖“检查更新”按钮，必须用已验证的 .vsix 文件覆盖安装，并确保语言服务器、架构、版本三者全部就位；否则会出现“已安装但功能全失效”的假成功现象。
拖拽 .vsix 进主窗口是最稳的更新方式
只要 VSCode 已启动、有系统焦点（任务栏图标高亮）、且处于非全屏状态，把未解压的 .vsix 文件直接拖进编辑器中央白底区域（不是侧边栏、不是设置页），松手就会弹出确认框。这个操作不查签名、不联网、不依赖 code 命令，内网、远程桌面、ARM Mac 全适配。
- 拖的是解压后的文件夹？VSCode 静默忽略，无任何提示
- VSCode 处于 RDP/TeamViewer 连接中？拖放事件常被拦截，切回本地窗口再试
- 安装后插件仍显示“已禁用”？必须手动点启用，或彻底退出 VSCode 后重启
- 右下角显示
Extensions disabled by policy？说明被组策略锁死，GUI 和命令行都会失败
code --install-extension 报 “not compatible” 怎么快速定位
这个错误 95% 是 .vsix 内 extension/package.json 的 "engines": {"vscode": "^1.85.0"} 与本地版本不匹配，不是网络或路径问题。
- 运行
code --version，取输出第一段（如1.85.2→1.85） - Linux/macOS 下执行：
unzip -p your.vsix extension/package.json | grep vscode - Windows 下可用 7-Zip 打开
.vsix，查看extension/package.json中的vscode字段 - 本地版本必须 ≥ 插件声明的最小版本；若为
1.84.3而插件要求^1.85.0，安装会静默拒绝 - ARM Mac 上装了 x64 构建的插件（尤其含
pyright-server或volar-server），也会触发同类报错，需找带darwin-arm64标识的版本
插件显示已更新，但 Python/Vue/TypeScript 功能不工作
这不是插件没装好，而是语言服务器（LSP）根本没落地——.vsix 只注册前端，首次启用才下载 pyright、volar-server、tsserver 等 native 二进制，离线环境卡在状态栏 “Downloading…” 就是这个原因。
- 正确做法：在有网机器上完整触发一次——打开一个
.py文件 → 等状态栏变绿 / 不再显示下载提示 → 再去%USERPROFILE%\.vscode\extensions\（Windows）或$HOME/.vscode/extensions/（macOS/Linux）里整个拷贝对应目录（如ms-python.python-2024.6.0/） - 不能只拷
.vsix，也不能只拷node_modules；native 二进制藏在子目录（如dist/server/pyright），漏一个就启动失败 - 复制完必须彻底退出 VSCode（包括右下角托盘进程），否则缓存不刷新
- 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），看 Console 是否报Pylance initialization timeout或gopls connection failed
手动复制到 extensions 目录的命名规则
在无 GUI 或 CLI 不可用的服务器上，只能手动解压 + 复制，但 VSCode 启动时靠**目录名**识别插件，不是靠文件内容，命名错一位就加载失败。
- 先用
unzip -l prettier-3.2.5.vsix查顶层目录名，例如看到esbenp.prettier-vscode-9.10.3/—— 这整个字符串就是扩展 ID + 版本号，必须原样作为子目录名 - 不能把
.vsix文件本身丢进extensions目录 - 不能解压后删掉外层目录，把里面内容平铺进去
- 路径必须严格匹配：
$HOME/.vscode/extensions/esbenp.prettier-vscode-9.10.3/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\esbenp.prettier-vscode-9.10.3\（Windows）
最易被忽略的点：所有操作完成后，VSCode 必须完全退出（包括托盘进程），否则它会从内存缓存加载旧插件，新文件形同虚设。
