Material Theme UI 插件更新需通过Settings > Plugins点击“Update”按钮，当前稳定版为v9.2.0，适配WebStorm 2026.2；更新后必须重启IDE才能生效，否则图标等资源不刷新；若报“incompatible”错误，应卸载旧插件、清空缓存目录后重新安装匹配版本。
Material Theme UI 插件怎么更新？
插件更新不靠手动下载替换，WebStorm 会自动检查并提示——但前提是没被你禁用自动更新或网络卡住。打开 Settings > Plugins，找到已安装的 Material Theme UI，如果右侧显示「Update」按钮，直接点它；若显示「Up to date」，说明已是最新版（当前稳定版为 v9.2.0，适配 WebStorm 2026.2）。
更新后图标没变？先确认是否重启了 IDE
Material Theme UI 的 UI 主题和图标渲染深度耦合，更新后必须重启 WebStorm 才生效，仅「Apply」或「Reload window」不够。常见现象是菜单栏颜色变了，但文件树/标签页图标还是旧的——这就是没重启导致的资源未重载。重启前可先执行 File > Manage IDE Settings > Refresh IDE Cache and Restart，避免缓存残留干扰新图标渲染。
更新失败报错 “Plugin is incompatible” 怎么办？
这类错误基本是因为插件版本与 WebStorm 内核不匹配。2026 年起 JetBrains 强制要求插件声明 since-build 和 until-build，而旧版 Material Theme UI（如 v8.x）已不支持 WebStorm 2026.2+。此时不要硬装，应：
- 卸载当前插件：
Settings > Plugins→ 找到Material Theme UI→ 点击齿轮图标 →Uninstall - 清空插件缓存：关闭 WebStorm，删除
$CONFIG_DIR/plugins/material-theme-ui目录（Windows 默认在%APPDATA%\JetBrains\WebStorm2026.2\plugins\） - 重新安装：回到
Plugins页面，搜索Material Theme UI，确保看到的是作者为Chris C. L.、版本号含v9.2.x的条目，再点 Install
Atom Material Icons 更新后图标仍不显示？
这个插件依赖 Material Theme UI 提供的图标注册机制，单独更新它大概率失效。必须保证两者版本兼容：Material Theme UI ≥ v9.2.0 + Atom Material Icons ≥ v4.2.0。另外，更新后需手动启用图标：
- 进
Settings > Appearance & Behavior > System Settings > Atom Material Icons - 勾选
Enable File Icons、Enable Directory Icons、Enable UI Icons - 别漏掉
Use colored file icons（否则全是灰调）
改完必须重启，且首次启动可能有 1–2 秒图标延迟加载，属正常现象。
