主题配置被忽略需先启用$cfg['ThemeManager'] = true;，再确保$cfg['ThemePath']为'themes'、$cfg['ThemeDefault']与目录名完全一致，且主题含有效theme.json和css/theme.css；PHP 8.2+还需补全"name"字段，同时禁用CDN、检查字体路径与缓存。
config.inc.php 里主题配置被忽略？先确认 $cfg['ThemeManager'] 是否启用
phpmyadmin 不会自动加载 themes/ 下的任何目录，必须显式开启主题管理器。很多用户改了 $cfg['themedefault'] 却没生效，根本原因是 $cfg['thememanager'] 还是 false 或压根没写。
- 打开
config.inc.php，找到$cfg['Servers'][$i]['auth_type'] = 'cookie';后面的位置（不能放在$cfg['Servers']块内部） - 确保有这一行：
$cfg['ThemeManager'] = true;；5.0+ 版本默认为true，但升级后旧配置可能保留false -
$cfg['ThemePath']必须设为'themes'（不是./themes、/var/www/html/phpmyadmin/themes或themes/带尾斜杠） -
$cfg['ThemeDefault']的值必须与themes/下子目录名**完全一致**：大小写、连字符、无空格——比如目录叫pmahomme，就不能写成Pmahomme或pmahomme-theme
主题目录结构不对，phpMyAdmin 直接跳过加载
phpMyAdmin 会扫描 themes/ 下每个子目录，但只认符合规范的——缺一个文件就当无效主题，连错误提示都不给，静默 fallback 到 original。
- 主题目录内必须包含
theme.json，且其中compat_version字段值必须精确匹配 phpMyAdmin 主版本号，例如 5.2.x 就写"5.2"，写"5"或"5.2.1"都不识别 -
css/theme.css必须存在，路径不能是css/main.css或CSS/theme.css（大小写敏感） - PHP 8.2+ 环境下，
theme.json若缺失"name"字段，会触发Undefined array key "name"致使整个主题列表为空 - 不要把主题解压进
themes/original/或themes/pmahomme/css/这类嵌套路径——主题必须是themes/xxx/这一级目录
浏览器或服务器缓存让新配置“看起来没变”
改完配置和文件后页面还是旧样式，大概率不是配置错，而是资源没刷新。phpMyAdmin 会合并 CSS、缓存 theme.json 解析结果，甚至浏览器会硬记住旧字体路径。
- 浏览器端：用无痕窗口访问，或按
Ctrl+Shift+R强制重载全部资源（包括 CSS 和字体） - 服务端：如果启用了 OPcache，需重启 PHP-FPM（如
sudo systemctl restart php*-fpm），否则config.inc.php修改不生效 - 若设置了
$cfg['TempDir']（比如/var/lib/phpmyadmin/tmp），确保该目录存在且www-data用户有读写权限，否则动态生成的 CSS 合并失败，主题样式无法注入 - 检查 Nginx/Apache 日志，看是否有
themes/xxx/css/theme.css返回 403 或 404——常见于宝塔面板默认禁止访问/themes/路径
图标丢失不是主题无效，而是 FontAwesome 或图片路径断了
导航栏空白、齿轮图标变成方块，常被误判为“主题没换成功”，实际是静态资源链断裂。新主题往往依赖本地字体或特定尺寸图标，而旧配置仍走 CDN 或路径错位。
- 在
config.inc.php中强制禁用 CDN：$cfg['FontAwesome'] = false;，否则国内环境大概率加载失败且无报错 - 确认
fonts/fontawesome-webfont.woff2文件存在且权限为644；Nginx 需声明font/woff2 woff2;MIME 类型，Apache 需AddType font/woff2 .woff2 - 直接在浏览器地址栏访问
/phpmyadmin/themes/xxx/img/icn_edit.png，看是否返回图片；404 说明img/目录没放对，或 Web 服务器 location 规则屏蔽了/themes/ - Firefox 用户特别注意：即使服务端已修复，它可能仍缓存着之前失败的字体请求，需在开发者工具 → Application → Clear storage 中清空 Cache Storage
