最稳的离线安装方式是拖入主窗口：确保vsix未解压、vscode有焦点且非全屏/远程状态，安装后需手动启用；命令行须用绝对路径；手动复制需解压并严格按扩展id目录名放入extensions文件夹且重启。
拖进主窗口是最稳的离线安装方式
VSCode 离线升级插件，最可靠、成功率最高的操作就是把 .vsix 文件直接拖进编辑器主工作区（不是侧边栏、不是设置页、不是终端面板）。只要 VSCode 正在运行且有焦点，松手就会弹出确认安装对话框。
这个动作绕过了所有网络请求和 CLI 配置依赖，对内网、远程桌面、无 GUI 环境都有效。但容易踩的坑有三个：
- 拖的是解压后的文件夹，不是原始
.vsix包——VSCode 会静默失败，无提示 - VSCode 处于全屏状态或远程 SSH 连接中（尤其某些 Windows 远程桌面会拦截拖放事件）
- 安装后插件默认禁用，必须手动点「启用」或重启 VSCode 才生效
命令行安装必须用绝对路径，且注意反斜杠转义
当需要脚本化批量部署时，code --install-extension 是唯一可用的命令行入口。它不走网络，只读取本地文件并写入 extensions 目录，但路径必须是绝对路径。
常见错误现象：执行后无反应、提示“Extension not found”或“ENOENT”。根本原因几乎都是路径问题：
- Linux/macOS 下用了相对路径，比如
code --install-extension ./prettier.vsix→ 改成/home/user/ext/prettier.vsix - Windows 下用单反斜杠：
C:extprettier.vsix→ 命令行会把e当作转义符，应改用正斜杠C:/ext/prettier.vsix或双反斜杠C:\ext\prettier.vsix - 路径含空格未加引号，如
C:/my ext/prettier.vsix→ 必须写成"C:/my ext/prettier.vsix"
手动复制到 extensions 目录要严格匹配扩展 ID 目录名
在无图形界面、权限受限或 CLI 不可用的服务器上，只能手动解压 + 复制。这一步最容易出错，因为 VSCode 启动时靠目录名识别插件，而不是靠文件内容。
正确流程是：
- 先用
unzip -l prettier-3.2.5.vsix查顶层目录名，比如看到esbenp.prettier-vscode-9.10.3/—— 这整个字符串就是扩展 ID + 版本号，必须原样作为子目录名 - 不能把
.vsix文件本身丢进extensions目录 - 不能解压后删掉外层目录，把里面内容平铺进去
- 复制完成后，必须完全退出 VSCode（包括托盘进程），否则缓存可能跳过加载
插件装上了却不生效？先查版本兼容性和引擎声明
离线安装后功能没出来，90% 不是安装失败，而是兼容性断层。VSCode 不会报错，只会静默跳过加载。
打开 .vsix 文件（本质是 zip），解压后看 package.json 里的 "engines": {"vscode": "^1.75.0"} 字段。如果你的 VSCode 是 1.72.0，那它根本不会被加载——连日志里都不会出现错误提示。
其他关键检查点：
- 插件是否要求额外运行时？比如
ms-python.python需本地有 Python 可执行文件，否则启用即报Python interpreter not found - 是否启用了冲突插件？例如两个格式化插件同时激活，可能导致其中一个被压制
- 插件更新后是否需要重载窗口？部分语言服务类插件（如
redhat.vscode-yaml）必须手动执行Developer: Reload Window
