最稳的离线安装方式是直接拖拽.vsix到vscode编辑区，不走网络、不依赖命令行；若失败需检查策略禁用、全屏、ssh连接或缩放问题。
直接拖拽 .vsix 到编辑区是最稳的安装方式
VSCode 已启动、有工作区（哪怕只是空文件夹）、窗口有焦点时，把未解压的 .vsix 文件直接拖进主代码编辑区域（不是侧边栏、不是设置页），松手就会弹出确认安装框。这个动作不走网络、不依赖 code 命令行、不触发策略拦截，是主题/图标类扩展离线安装成功率最高的方式。
如果拖进去没反应，先看右下角状态栏是否显示 Extensions disabled by policy——企业组策略可能已全局禁用扩展；再检查是否处于全屏、远程 SSH 连接未就绪、或多显示器缩放偏移导致拖拽区域识别失败。
用 code --install-extension 命令要特别注意路径和权限
该命令适合批量部署或脚本化，但容易因路径问题失败：
- Windows 下路径含空格必须加双引号：
code --install-extension "C:\ext\material-icon-theme-4.19.0.vsix" - Linux/macOS 必须用绝对路径：
code --install-extension /home/user/ext/night-owl-2.0.0.vsix - 若提示
command not found: code，说明 CLI 未注册：在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行 - 安装后插件默认禁用，需手动点「启用」或重启 VSCode；主题/图标类扩展一般不卡 LSP，但首次启用可能需手动选中（通过
Ctrl+K Ctrl+T或Ctrl+K Ctrl+I）
手动拷贝到 extensions 目录是绕过签名验证的应急方案
当 GUI 和 CLI 都被策略封锁，或需要部署带自定义资源的图标包（如含 SVG 图标、CSS 覆盖）时，只能解压直装。但这不是简单复制粘贴：
- 先用
unzip -l your-theme.vsix查顶层目录名，例如pkief.material-icon-theme-4.19.0/—— 这就是扩展 ID + 版本号，必须原样作为子目录名 - 解压后整个文件夹（含
package.json、icons/、themes/等）移入对应extensions路径：
Windows：%USERPROFILE%\.vscode\extensions\
macOS/Linux：$HOME/.vscode/extensions/ - VSCode 启动时会扫描该目录，但若
package.json里声明了"activationEvents": ["onStartup"]，仍需重启才生效
主题/图标扩展离线启用的关键细节
离线环境下最容易被忽略的是「启用状态」和「激活时机」：
- 所有离线安装的扩展（包括主题、图标）默认为禁用状态，必须手动点击「启用」按钮，或重启 VSCode 才能加载
- 图标扩展（如
material-icon-theme）依赖package.json中的iconDefinitions和fileExtensions字段，若你手动拷贝时漏掉了icons/子目录，图标就不会显示 - 主题扩展（如
night-owl）的themes/目录必须存在且结构正确，否则在Ctrl+K Ctrl+T列表里看不到选项 - 某些主题含 Webview 或 CSS 注入逻辑，若
security.workspace.trust.enabled为true（默认），离线加载可能被拦截，临时设为false可绕过
package.json 结构、资源路径、激活事件的依赖比普通功能扩展更敏感。离线安装成功 ≠ 立即可用，关键在目录完整性与启用动作是否真正完成。
