如果直接把$cfg['ThemeDefault']改回去,仍然可能看不到效果,因为在 phpMyAdmin 5.2 及以上版本中,默认内置主题已经不是original,而是pmahomme。因此,想要恢复 phpMyAdmin 默认主题,需要先确认themes/pmahomme/目录完整存在(至少包含theme.json和css/theme.css),同时保证$cfg['ThemeManager']设置为true、$cfg['ThemePath']设置为'themes',并在修改后及时清除浏览器缓存与字体缓存。

直接改回 $cfg['ThemeDefault'] 不一定能恢复默认主题
很多用户认为,只要把 config.inc.php 中的 $cfg['ThemeDefault'] = 'pmahomme'; 改成 'original',或者干脆删除这一行,就能恢复 phpMyAdmin 默认主题。但实际操作后,页面往往仍然显示旧样式。原因是:在 phpMyAdmin 5.2+ 版本里,original 主题已经不再作为默认主题使用,当前真正的默认内置主题是 pmahomme。如果之前手动切换过主题,却没有确认 themes/pmahomme/ 目录是否完整,那么即使配置参数写对,系统也可能回退到基础样式,甚至提示 cannot load theme 错误。
检查 themes/pmahomme/ 目录是否完整可用
phpMyAdmin 在启动时会扫描 themes/ 目录下的子目录,并尝试读取其中的 theme.json 文件。如果 themes/pmahomme/ 被误删、被重命名,或者目录内缺少 theme.json、css/theme.css 等关键文件,就会导致 phpMyAdmin 无法识别该主题,从而出现界面无样式、样式错乱,甚至白屏的问题。这种情况在 XAMPP 升级或手动覆盖程序文件后尤其常见,比如整个 themes/ 目录被替换,但只保留了用户自己创建的 mytheme 子目录,结果默认的 pmahomme 主题丢失。
- 确认路径为
/var/www/html/phpmyadmin/themes/pmahomme/(Linux)或XAMPPphpMyAdminthemespmahomme(Windows) - 该目录下必须有:
theme.json(含"name"和"compat_version"字段)、css/theme.css、img/(可为空) - 若缺失,最稳妥的处理方式是重新下载对应版本的 phpMyAdmin 安装包,从中提取完整的
themes/pmahomme/文件夹进行覆盖
清除浏览器缓存,并排查本地字体缓存干扰
即使配置项和主题文件都没有问题,浏览器也可能继续缓存旧版 CSS,或者保留失效的 FontAwesome 字体文件,进而造成图标显示为方块、按钮没有 hover 效果、导航栏排版错位等现象。这些问题经常会被误认为是“phpMyAdmin 默认主题没有恢复成功”。尤其是 Firefox,对字体缓存的保留相对顽固,即使服务器端已经修复,它仍可能继续使用之前加载失败的 fontawesome-webfont.woff2 缓存文件。
- 强制刷新:Ctrl+F5(Windows/Linux)或 Cmd+Shift+R(macOS)
- 更彻底:打开开发者工具 → Application → Clear storage → 勾选 “Cache storage” 和 “Local storage”,然后刷新
- 临时禁用 CDN 字体:在
config.inc.php中添加$cfg['FontAwesome'] = false;,避免因网络拦截导致字体加载失败
不要忽略 $cfg['ThemeManager'] 和 $cfg['ThemePath'] 设置
仅仅修改 $cfg['ThemeDefault'] 通常还不够。如果 $cfg['ThemeManager'] = false;(某些旧版本或升级后的遗留配置中可能存在),那么主题切换功能本身就是关闭状态;而如果 $cfg['ThemePath'] 设置错误,比如写成 './themes' 或 'themes/',phpMyAdmin 也无法正确找到 pmahomme 目录,自然无法正常加载默认主题。
- 确保
$cfg['ThemeManager'] = true;已启用(5.0+ 默认 true,但升级后配置可能被覆盖) $cfg['ThemePath}必须是相对于 phpMyAdmin 根目录的相对路径,只填'themes',不能带斜杠前缀或后缀- 修改配置后,建议重启 Web 服务(Apache/Nginx),或者至少清空 OPcache(例如在 PHP-FPM 环境下执行
sudo systemctl reload php-fpm)
themes/pmahomme/ 目录被悄悄破坏,或者浏览器一直使用旧的字体与样式缓存。