离线安装VSCode主题插件流程与普通插件一致，但无需处理LSP或native依赖；失败主因是版本不兼容、拖放条件未满足（窗口无焦点/非原始.vsix/VSCode版本低于engines.vscode要求）或安装后未手动启用并应用。
离线安装 VSCode 主题插件和普通插件流程一致，但主题类插件（如 dracula-theme.theme-dracula、github.github-vscode-theme）没有 LSP 或 native 二进制依赖，因此失败概率更低——真正卡住的往往是版本不兼容或拖放条件没满足。
拖拽 .vsix 到编辑区没反应？先确认这三件事
这是主题插件离线安装最常被误判为“失败”的场景。VSCode 不会报错，只是静默忽略：
- VSCode 窗口必须有系统焦点：点击编辑器任意空白处，确保任务栏图标高亮
- 拖入的是未解压的原始
.vsix文件（用unzip -l theme.vsix看顶层是否含extension/目录） - VSCode 版本 ≥ 主题插件
package.json中"engines": {"vscode": "^1.80.0"}声明的最低版本；例如你本地是1.79.2，而主题要求^1.80.0，它就根本不会加载
code --install-extension 安装主题时路径和参数怎么写
命令行方式适合批量部署或脚本化，但对路径极其敏感：
- Windows 下路径含空格或中文，必须加英文双引号：
code --install-extension "D:\vscode-themes\dracula-theme.theme-dracula-4.1.0.vsix" - Linux/macOS 必须用绝对路径：
code --install-extension /home/user/themes/github.github-vscode-theme-1.0.5.vsix - 离线环境报
INVALID_SIGNATURE？加--allow-unverified参数：code --install-extension theme.vsix --allow-unverified - 若提示
command not found: code，不是 PATH 问题，而是 CLI 未注册：在 VSCode 中按Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并执行
装完主题不生效？别只看扩展面板
主题插件安装后默认是禁用状态，且 VSCode 不会自动切换到它：
- 打开扩展面板，找到刚装的主题，手动点「启用」按钮（或右键 → Enable）
- 启用后还需手动应用：按
Ctrl+K Ctrl+T（Windows/Linux）或Cmd+K Cmd+T（macOS），从列表中选中该主题 - 如果选了没变化，检查是否被用户设置覆盖：打开
settings.json，确认没有硬编码的"workbench.colorTheme"值冲突 - 极少数主题（如某些自定义 CSS 主题）依赖
vscode-custom-css插件，这个插件本身也得离线装好并启用
主题插件看似简单，但最容易被忽略的是版本兼容性——它不像语言插件那样会卡在 “Downloading LSP”，而是直接静默跳过加载，连错误日志都不留。验证前务必打开 .vsix 解压后的 package.json，比对 engines.vscode 和本地 code --version 输出。
