在 config.inc.php 中设置 $cfg['ThemeDefault'] = 'pmahomme'; 需置于 / Server(s) configuration / 之后、任何 require_once 加载主题前，确保 phpMyAdmin ≥ 4.8、主题目录完整可读且 theme.json 合法，避免缓存干扰。
如何在 config.inc.php 中设置 $cfg['ThemeDefault']
phpMyAdmin 的主题切换依赖于 $cfg['ThemeDefault'] 配置项，它必须写在 config.inc.php 中（不是 config.sample.inc.php），且需在 require_once 加载主题系统之前生效。常见错误是把这行加在文件末尾，或加在 /* User preferences */ 注释块之后——此时 phpMyAdmin 已初始化主题管理器，赋值会被忽略。
实操建议：
- 确认 phpMyAdmin 版本 ≥ 4.8（旧版用
$cfg['ThemePath']和$cfg['ThemeManager']，逻辑不同） - 打开
config.inc.php，在/* Server(s) configuration */区块之后、任何require_once或include主题相关文件之前插入：
$cfg['ThemeDefault'] = 'pmahomme';
pmahomme 是官方默认主题名，其他可用主题需实际存在于 themes/ 目录下（如 metro、bootstrap），主题名即子目录名，区分大小写。
为什么改了 $cfg['ThemeDefault'] 却没生效
最常被忽略的是权限与缓存问题：phpMyAdmin 启动时会检查 themes/ 下每个子目录的 theme.json 是否合法，并缓存结果到 tmp/（或系统临时目录）。即使配置写对，若主题目录损坏、theme.json 缺失或 PHP 进程无权读取该目录，phpMyAdmin 会静默回退到内置 fallback 主题（通常是 original），且不报错。
立即学习“PHP免费学习笔记（深入）”；
排查步骤：
- 检查
themes/pmahomme/theme.json是否存在且 JSON 格式正确（可用json_last_error()快速验证） - 确认 Web 服务器用户（如
www-data或nginx）对themes/及其子目录有读取权限 - 清空
tmp/目录（或设置$cfg['TempDir']指向可写路径），避免旧缓存干扰 - 查看 PHP 错误日志，搜索
Theme或theme.json相关警告
使用 $cfg['ThemeManager'] = false 的副作用
有些文档建议关闭主题管理器来“强制固定主题”，即设置 $cfg['ThemeManager'] = false。这确实能禁用界面右上角的主题切换按钮，但不会让 $cfg['ThemeDefault'] 更可靠——反而可能触发降级逻辑：当主题加载失败时，phpMyAdmin 会跳过所有主题直接使用硬编码的原始样式，导致界面错位、图标丢失。
更稳妥的做法是：
- 保持
$cfg['ThemeManager'] = true（默认值） - 确保目标主题完整、可读、通过校验
- 如需隐藏切换入口，用 CSS 覆盖
#theme_selector元素，而非关闭功能模块
多服务器配置下主题是否共用
$cfg['ThemeDefault'] 是全局配置，对所有已定义的服务器（$cfg['Servers'][1]、$cfg['Servers'][2]…）统一生效。它不支持 per-server 主题，也没有 $cfg['Servers'][$i]['ThemeDefault'] 这样的键。如果需要不同服务器呈现不同风格，只能通过反向代理或 URL 路径隔离多个 phpMyAdmin 实例，各自维护独立的 config.inc.php 和 themes/ 目录。
注意：$cfg['Servers'][$i]['extension'] 或 $cfg['Servers'][$i]['auth_type'] 等配置不会影响主题加载路径或行为，别指望靠它们间接控制主题。
