phpMyAdmin 5.2+ 原生支持 dark 主题，需在 config.inc.php 全局配置区添加 $cfg['ThemeDefault'] = 'dark';（大小写敏感），修改后需重新登录并强制刷新生效。
phpMyAdmin 5.2+ 版本如何启用内置 Dark 主题
phpMyAdmin 自 5.2.0 起原生支持 dark 主题，无需第三方插件或手动改 CSS。但默认不启用，且主题切换逻辑依赖用户配置而非全局设置。
- 必须以「已登录用户」身份操作，匿名访问无法保存主题偏好
- 修改的是当前用户的
config.inc.php中的$cfg['ThemeDefault']值，不是界面按钮切换（按钮只临时生效，刷新即失效） - 若使用多服务器配置（
$cfg['Servers']数组），主题设置需放在$cfg全局作用域，不能写在某个 server 子数组里 - 修改后需清空浏览器缓存或强制刷新（
Ctrl+F5），否则可能仍加载旧 CSS 缓存
修改 config.inc.php 的正确位置和写法
直接编辑 phpMyAdmin 根目录下的 config.inc.php，在 /* Server(s) configuration */ 区块之前（即全局配置区）添加或修改这一行：
$cfg['ThemeDefault'] = 'dark';
注意：dark 是主题名，不是路径或文件名；大小写敏感，写成 Dark 或 DARK 会失败并回退到默认主题。
- 如果该文件里已有
$cfg['ThemeDefault']，直接覆盖其值即可，不要重复定义 - 确保这行不在
if或函数体内，必须是顶层赋值语句 - 修改后重启 Web 服务非必需，但 Apache/Nginx 若启用了 OPcache，可能需要执行
opcache_reset()或重启 PHP-FPM
为什么点界面右上角“Theme”下拉选 dark 没用？
phpMyAdmin 界面顶部的主题切换器只是前端临时预览，它通过 JS 动态加载对应 CSS 并写入 localStorage，但不修改任何配置文件，也不影响后续登录状态。关闭页面或换设备后立即失效。
立即学习“PHP免费学习笔记（深入）”；
- 该下拉菜单本质是调试工具，不是持久化设置入口
- 它的选项来源于
themes/目录下的子目录名，若你看到dark选项，说明主题已存在；若没有，说明版本低于 5.2 或主题目录被删减 - 可通过访问
http://your-pma-url/themes/dark/直接测试主题资源是否可读（应返回 403 或 404，而非 403+乱码——后者表示路径解析异常）
常见错误：改了配置却仍是亮色，怎么排查？
最常被忽略的是权限与路径问题：phpMyAdmin 启动时若无法读取 config.inc.php，会静默降级为内置默认配置（主题为 pmahomme）。
- 检查
config.inc.php文件权限是否为644，所属用户是否与 Web 进程一致（如 www-data、nginx） - 查看 PHP 错误日志，搜索
Failed to load configuration file或Warning: include(): Failed opening 'config.inc.php' - 确认没启用
$cfg['ConfigFile']指向其他配置文件，导致你改的不是实际加载的那个 - 运行
SELECT @@version;确认 phpMyAdmin 版本，SHOW VARIABLES LIKE 'version_comment';只显示 MySQL 版本，别混淆
暗黑模式真正生效的标志是左上角 phpMyAdmin logo 文字变为浅灰、数据库列表背景为深灰、SQL 输入框底色变暗——这些样式由 themes/dark/css/theme.css 控制，而不是靠 JS 覆盖。
