phpMyAdmin 5.2+ 原生支持深色模式，需在 config.inc.php 中设置 $cfg['DarkMode'] = true 并确保使用默认 pmahomme 主题；不自动跟随系统偏好，也不提供界面开关，配置错误或主题不兼容将导致失效。
phpMyAdmin 5.2+ 原生支持深色模式，但默认不启用
phpmyadmin 自 5.2.0 版本起内置了基于 css 变量的深色主题（dark），无需插件或手动改 css。但它不会自动跟随系统偏好，也不在界面提供开关按钮——必须通过配置文件显式启用。
常见错误现象：config.inc.php 里加了 $cfg['ThemeManager'] = true; 却没生效，是因为这个选项只控制主题切换器是否显示，和深色模式无关。
- 确认版本：运行
phpmyadmin --version或查看登录页底部文字，低于5.2.0的需升级 - 修改
config.inc.php（通常在/etc/phpmyadmin/或phpmyadmin/libraries/下） - 添加这行配置（放在
$cfg数组赋值之后）：$cfg['DarkMode'] = true;
- 重启 Web 服务（如
systemctl restart apache2或nginx）后刷新页面
深色模式不生效？检查 $cfg['Theme'] 和 $cfg['DarkMode'] 的优先级关系
$cfg['DarkMode'] = true 是开关，但最终渲染还依赖当前激活的主题是否支持深色变体。phpMyAdmin 默认主题 pmahomme 支持，但如果你手动设过 $cfg['Theme']，可能用了旧主题或自定义主题，它们大概率没实现 --dark-* CSS 变量。
- 删掉或注释掉类似
$cfg['Theme'] = 'some_old_theme';的行，让 phpMyAdmin 回退到默认pmahomme - 如果必须用其他主题，请确认它发布于 2022 年后、明确声明支持 Dark Mode，否则即使
$cfg['DarkMode'] = true也只会渲染成灰蒙蒙的半成品 - 浏览器开发者工具里检查
<body>元素是否有dark-modeclass，没有就说明配置未加载或被覆盖
想一键切换？用 JavaScript 注入临时开启（仅限调试，不推荐生产环境）
正式环境必须走 config.inc.php 配置，但开发时快速验证深色效果，可以用浏览器控制台执行脚本绕过服务端限制。注意：刷新即失效，且部分样式（如 SQL 编辑器高亮）可能不完整。
- 打开 phpMyAdmin 页面，在浏览器控制台粘贴并回车：
document.body.classList.add('dark-mode'); document.documentElement.style.setProperty('--pma-bg', '#1e1e1e'); - 该脚本只是模拟，不触发 phpMyAdmin 内部的深色逻辑（比如日期选择器、弹窗等仍可能白底）
- 某些 CDN 加载的 JS（如
jquery.js）若被拦截，可能导致脚本报错$ is not defined，此时换用原生document.body.className += ' dark-mode'
护眼不是越暗越好：深色模式下的可读性陷阱
phpMyAdmin 的深色模式用的是 #1e1e1e 主背景 + #ffffff 文字，对比度高达 18:1，看似护眼，实则易引发视觉疲劳——尤其长时间看 SQL 结果表或 JSON 字段时，纯黑背景会让白色文字“刺眼”。
立即学习“PHP免费学习笔记（深入）”；
- 真正护眼的深色应是深灰（如
#2d2d2d）配浅灰文字（#e0e0e0），但 phpMyAdmin 不提供 UI 调节入口 - 如需微调，只能在
config.inc.php后追加自定义 CSS：$cfg['HeaderLogoLink'] = 'data:text/css;charset=utf-8, body.dark-mode { --pma-bg: #2d2d2d; --pma-fg: #e0e0e0; }';（利用HeaderLogoLink注入 CSS 是少数安全的 hack 方式） - 别碰
themes/目录下的 CSS 文件——升级 phpMyAdmin 时会被覆盖，且无版本兼容保证
配置写错一个字母，$cfg['DarkMode'] 就会静默失效；而主题路径写错，可能直接导致整个 phpMyAdmin 白屏。最稳妥的做法永远是：先备份 config.inc.php，再改一行，再刷新验证。
