phpMyAdmin 5.2+ 无可靠“一键美化”工具，因其主题系统已重构为依赖 CSS 变量和 body.darkmode 类，旧脚本硬改 pmahomme 目录或忽略状态样式覆盖，极易导致界面错乱、高亮异常或升级失效；官方唯一安全方式是配置 $cfg['DarkMode'] = true 或规范使用 ./themes/custom/ 自定义主题。
没有官方或社区维护的“phpmyadmin 5.2 专用一键美化脚本”——所谓“一键美化”工具，要么是改 config.inc.php 的简单封装，要么是直接覆盖 css 的半成品，多数在 5.2+ 上会失效或引发样式错乱。
为什么找不到真正可靠的“一键美化”工具
phpMyAdmin 5.2+ 彻底重构了主题系统：CSS 依赖 body.darkmode 类和 CSS 变量（如 --pma-bg），不再靠 @media (prefers-color-scheme: dark) 自动适配；所有自定义主题必须放在 ./themes/custom/ 下独立子目录，且需完整覆盖按钮、表单、弹窗等组件的状态样式（:hover、:disabled、.ajax 等）。大多数“美化脚本”仍按旧版逻辑硬改 themes/pmahomme/css/，升级后立即丢失，或导致 SQL 编辑器高亮异常、日期选择器白底等兼容问题。
手动启用深色模式只需一行配置
如果你只是想快速启用原生深色主题（非“美化”，而是官方支持的暗色 UI），确认版本 ≥ 5.2.0 后，只需修改 config.inc.php：
- 找到
$cfg数组赋值块之后的位置（不要放在if条件里或注释中） - 添加：
$cfg['DarkMode'] = true; - 确保没设置
$cfg['Theme']指向老主题（如'original'或自定义路径），否则深色变体不加载 - 重启 Web 服务（
systemctl restart apache2或nginx），清空浏览器缓存再访问
生效后，<body> 应含 dark-mode class（注意不是 darkmode），且开发者工具中可查到 --pma-bg 等变量已注入。
想换主题？别碰 pmahomme，用 custom/ 目录
任何实质性“美化”（比如圆角按钮、渐变背景、自定义字体）都必须走标准主题路径，否则升级即归零：
立即学习“PHP免费学习笔记（深入）”；
- 在
XAMPP\phpMyAdmin\themes\下新建custom/mytheme/（不能叫pmahomme） - 把整个
pmahomme/复制进去（保留css/、img/、templates/结构） - 编辑
mytheme/css/common.css，用body.darkmode .btn { ... }覆盖暗色状态，而非只写.btn - 在
config.inc.php中设：$cfg['ThemePath'] = './themes';和$cfg['ThemeDefault'] = 'mytheme'; -
input[type="submit"]必须加cursor: pointer才响应:hover，否则悬停无效
复杂点在于：phpMyAdmin 的 JS 会在按钮点击后动态加 .ajax 或 .disabled 类，你的 CSS 选择器权重若不够（比如只写 .btn:hover），就会被覆盖。最稳写法是：.btn:hover, .btn.ajax:hover, .btn.disabled:hover { ... }。
真正容易被忽略的是：深色模式不是“开了就全黑”，它依赖主题对 CSS 变量的完整实现。哪怕 $cfg['DarkMode'] = true 成功，如果自定义主题没定义 --pma-bg-dark 或漏了 body.darkmode .table th 样式，表格头部依然白底刺眼——这不是配置错了，是主题本身没填完坑。
