必须安装 Material Theme UI 插件（非 Material Theme），作者为「Material Theme」团队、版本≥9.7.0，安装后需重启 IDE；UI 主题与编辑器配色方案须同名匹配（如均选 Material Theme - Darker）才生效。
装错名字就白忙——必须搜 Material Theme UI，不是 Material Theme。
搜插件时输错名，根本装不上
JetBrains Marketplace 里有三个名字极像的插件：Material Theme（已弃用）、Material Theme UI（当前维护、适配 WebStorm 2025+）、Material Theme UI Darker（只是配色方案，不是插件）。输错一个词，装完重启也看不到配置入口。
- 在 Settings > Plugins > Marketplace 搜索框里，**必须完整输入
Material Theme UI** - 认准作者是「Material Theme」团队，版本号 ≥ 9.7.0（适配 WebStorm 2025.3）
- 点 Install 后，弹出提示必须点 Restart IDE —— 不重启，Settings 里压根不显示 Material Theme 配置页
装完主题没生效？两处开关要手动开
UI 主题和编辑器配色方案是完全独立的两个设置，只开一个，代码区还是白底黑字。
- Settings > Appearance & Behavior > Appearance > Theme 下拉菜单中选
Material Theme - Darker（改菜单栏/侧边栏） - Settings > Editor > Color Scheme > Scheme 下拉菜单中**同样选
Material Theme - Darker**（改代码编辑区） - 如果下拉列表里没有这个选项，点右上角齿轮 →
Restore Defaults，再重装插件或重启一次
离线安装失败，大概率是版本不匹配
内网环境手动下载 ZIP 安装，失败日志里出现 Plugin 'Material Theme UI' is incompatible with this version of the IDE，说明 ZIP 版本和 WebStorm 不兼容。
- 别直接下最新版 ZIP，去 JetBrains Plugin Repository 找对应 WebStorm 版本的 release。例如 WebStorm 2025.3 对应
Material Theme UI 9.7.0，2026.1 可能需10.0.0+ - 安装方式：Settings > Plugins > ⚙️ >
Install plugin from disk…→ 选中 ZIP 文件（不是解压后的文件夹） - 装完无反应？看 Help >
Show Log in Explorer，确认报错类型再换低一版 ZIP
图标灰色、字体发虚，不是插件问题
这些视觉异常几乎都来自配套设置缺失，跟插件本身无关。
- 图标不染色：必须单独安装
Atom Material Icons插件，装完进 Settings > Appearance & Behavior >AtomMaterialIconsSetting勾选启用 - 字体发虚：Settings > Appearance & Behavior > Appearance >
Use custom font改为Fira Code或JetBrains Mono；取消勾选Enable font ligatures和Use anti-aliasing（Windows 下还要关 ClearType） - Tab 太高/太矮：Settings > Editor > General > Tabs >
Tab Height调到 26 是多数人舒适值
最容易被忽略的是：UI 主题和 Color Scheme 必须严格同名匹配，哪怕只差一个空格或大小写，编辑器背景就不会变暗。很多人反复重装插件，其实只要打开 Settings 把两个下拉框点对就行。
