phpMyAdmin 5.2+ 已废弃旧主题机制，$cfg['ThemePath']和$cfg['ThemeDefault']配置无效，主题样式由./css/theme.css和./css/common.css控制，图标依赖本地FontAwesome字体，需禁用CDN并配对MIME类型。
升级后主题失效不是“换不上去”，而是 phpmyadmin 5.2 彻底废弃了旧版主题机制，原 themes/pmahomme/ 目录被降级为仅图标资源路径，$cfg['themepath'] 配置已无效，强行沿用 4.9 的配置只会让 css 加载失败或被忽略。
为什么 config.inc.php 里设了 ThemePath 和 ThemeDefault 没用？
phpMyAdmin 5.0+ 移除了完整主题系统，5.2 版本中：$cfg['ThemePath'] 仅用于加载极简皮肤（如按钮边框、导航栏背景色），不再控制整体样式；$cfg['ThemeDefault'] 已被弃用，设了也无 effect。你升级后保留的 4.9 配置会干扰新版行为，比如强制加载不存在的 CSS 文件导致 404，或覆盖掉新版必需的 theme.css 路径。
- 删掉 config.inc.php 中所有以
$cfg['Theme开头的行（包括ThemePath、ThemeDefault、ThemeManager） - 确认
themes/目录下只有pmahomme/（且是 5.2 官方包解压所得），不要放任何 4.9 主题目录 - 新版默认样式由
./css/theme.css和./css/common.css控制，不是themes/pmahomme/css/下的文件
导航栏图标和按钮颜色全丢了，怎么救回来？
图标丢失主因是 FontAwesome CDN 加载失败，按钮变灰是因为新版 CSS 重写了所有 .btn 规则，而你残留的 4.9 自定义 CSS 与新选择器冲突。
- 在 config.inc.php 中添加：
$cfg['FontAwesome'] = false;（禁用 CDN，改用本地字体） - 检查
fonts/fontawesome-webfont.woff2是否存在且可访问（路径为/phpmyadmin/fonts/，非themes/下） - Nginx 用户需在
types块中加：font/woff2 woff2;；Apache 用户加：AddType font/woff2 .woff2 - 按钮配色别改
themes/pmahomme/，直接编辑./css/common.css，搜.btn修改背景色、hover 状态和:disabled样式
自定义 CSS 改了但刷新没反应？清缓存只是第一步
phpMyAdmin 5.2 启用 Twig 编译缓存和 JS/CSS 合并压缩，浏览器缓存只是表象，真正卡住的是服务端生成的 ./js/dist/theme.min.css 和 ./tmp/ 下的 Twig 缓存文件。
- 删掉整个
./js/dist/目录（不是只删theme.min.css） - 清空
./tmp/下所有文件（特别是cache/和twig/子目录） - 重启 Web 服务（
systemctl restart nginx或宝塔里重启站点） - 用隐身窗口访问，Network 面板过滤
css，确认加载的是theme.min.css?ver=5.2.1（带版本号）而非旧缓存
真正难搞的不是样式不生效，而是你以为在修主题，其实是在对抗一套已不存在的机制——5.2 的“主题”只剩图标和极简皮肤，其余全是硬编码 CSS 和 JS 控制。想长期稳定，就别套 4.9 主题，老老实实改 ./css/ 下那几个文件，顺便把 fonts/ MIME 类型配对。
立即学习“PHP免费学习笔记（深入）”；
