必须通过Plugins页面安装并重启IDE才能生效，否则后续所有设置无效；安装后需分别在Appearance中启用Material Theme UI界面主题、在Color Scheme中手动切换Material配色方案，二者缺一不可。
安装 Material Theme UI 插件本身
插件必须通过 Plugins 页面安装，不能靠复制文件或改配置目录生效。在 PhpStorm 中打开 Settings（Windows/Linux）或 Preferences（macOS），左侧点开 Plugins，顶部切到 Marketplace 标签页，搜索 Material Theme UI —— 注意名称里带空格和大小写，别输成 materialthemeui 或漏掉 UI。
找到官方发布者（作者是 Material Theme Team）的条目，点击 Install。安装完成后弹窗会提示重启，必须点 Restart IDE，否则插件资源不加载，后续所有设置都无效。
常见失败原因：
- 网络卡住导致搜索无结果：换用
Search in repositories按钮重试，或直接访问 插件页面 下载对应 PhpStorm 版本的.jar文件，再进Plugins→ 齿轮图标 →Install Plugin from Disk…手动安装 - 装完重启后仍看不到新主题选项：检查插件是否被禁用（
Plugins列表里勾选状态），也可能是版本不兼容——2026 年主流 PhpStorm 版本需用插件 9.x+，旧版插件只支持到 2023.3
启用 UI 主题（窗口/侧边栏外观）
插件装好重启后，Settings → Appearance & Behavior → Appearance，在 Theme 下拉菜单中会出现 Material Theme（不是 Material Oceanic，那是编辑器配色）。选中它，点 Apply，整个 IDE 的工具栏、项目树、设置窗口等区域立刻变灰蓝调，这才是“UI 美化”的第一层效果。
立即学习“PHP免费学习笔记（深入）”；
注意：Theme 和 Color Scheme 是两个独立开关。只设这里，编辑器代码区还是默认白底或 Darcula，视觉割裂感很强。
若下拉菜单里没出现 Material Theme：
- 确认插件已启用且重启过 IDE
- 检查是否误点了
Settings→Editor→Color Scheme路径，那里不会显示 UI 主题 - 极少数情况需手动清除缓存：关闭 PhpStorm，删掉
~/.cache/JetBrains/PhpStorm202X.X（Linux/macOS）或%LOCALAPPDATA%\JetBrains\PhpStorm202X.X\cache（Windows）再重开
激活编辑器配色（代码高亮部分）
UI 主题生效后，进 Settings → Editor → Color Scheme，在 Scheme 下拉菜单里找 Material Oceanic 或 Material Darker 这类带 Material 前缀的方案。选中后点 Apply，代码区才真正统一风格。
如果该方案显示为灰色不可选：
- 先点右侧的复制图标
Duplicate，生成一个可编辑副本 - 副本里点
Background项，把值改成#1E1E1E（比默认深一档，护眼更稳） - 再点
Apply，就能正常启用了
别跳过这步——很多用户以为装了插件就万事大吉，结果编辑器背景还是刺眼白或泛灰，其实是配色方案没手动激活，或者副本没保存成功。
为什么编辑器和侧边栏颜色不一致？
根本原因是 JetBrains 把界面皮肤（Theme）和语法高亮（Color Scheme）拆成两套系统管理。Material Theme UI 插件只提供 UI 框架资源和配套配色方案，但不会自动切换你当前正在用的 Color Scheme。哪怕你上个月用的是 Default，插件装完也不会帮你覆盖。
所以必须手动走两遍路径：Appearance 换 UI 主题 + Color Scheme 换编辑器配色。少一步，就会出现侧边栏是深蓝、代码区是惨白这种“精神分裂”效果。
另外，某些第三方 .icls 配色文件导入后显示异常（比如黑底里突然一块白背景），大概率是 Language Defaults → Background 被意外勾选了，进去取消勾选即可。这个选项平时不该开，开了反而破坏主题整体性。
