custom.css必须放在phpMyAdmin根目录下的css/子目录中，即./css/custom.css，且需在config.inc.php中配置$cfg['CustomCSS'] = 'custom.css';，路径错误或未启用配置将导致加载失败。
custom.css 文件必须放在 phpMyAdmin 根目录下的 css/ 子目录里
不是 themes/、不是 templates/、也不是任意自定义路径——phpmyadmin 只认 ./css/custom.css 这个固定位置（相对根目录）。如果你放错地方，比如 themes/pmahomme/css/custom.css 或 css/custom/custom.css，它根本不会被加载。
确认路径是否正确最直接的方法是：打开浏览器开发者工具 → Network 标签页 → 刷新 phpMyAdmin 首页 → 搜索 custom.css。如果看到 404，说明路径错了；如果看到 200 但样式没生效，再查其他问题。
$cfg['CustomCSS'] 配置项必须显式启用且值为 'custom.css'
仅把文件放对位置还不够。你得在 config.inc.php 中明确告诉 phpMyAdmin 去加载它：
- 确保该配置写在
$cfg['Servers'][$i]['auth_type'] = 'cookie';之后（顺序错会导致忽略） - 写法必须是
$cfg['CustomCSS'] = 'custom.css';，不能带路径前缀（如css/custom.css）、不能加引号以外的空格、不能用双引号混用 - 如果用了 XAMPP 或某些打包版，
config.inc.php可能在/etc/phpmyadmin/下，此时custom.css仍要放在 phpMyAdmin 实际 Web 根目录的css/里（不是/etc/下）
升级后 custom.css 失效？大概率是缓存或路径被重置
phpMyAdmin 升级不会覆盖 css/custom.css（它不在升级包内），但以下情况会让样式突然消失：
- 浏览器强缓存了旧 CSS：Ctrl+F5 强刷，或开隐身窗口验证
- 升级时你手动复制了整个 phpMyAdmin 目录，却漏掉了
css/custom.css文件 - 新版本启用了主题机制（如
$cfg['ThemeManager'] = true;），而你的 custom.css 选择器权重不够，被主题 CSS 覆盖 —— 此时必须加!important - 你改了
$cfg['ThemePath']或启用了自定义主题，但没意识到主题 CSS 会叠加加载，导致样式冲突
别把 custom.css 和主题 CSS 混着改
有人把自定义样式直接塞进 themes/pmahomme/css/theme.css，这是高危操作：
立即学习“PHP免费学习笔记（深入）”；
- 下次升级 phpMyAdmin，整个
themes/pmahomme/目录会被覆盖，你的修改全丢 - 主题 CSS 有更高优先级和更复杂的层叠逻辑，
custom.css的规则容易被静默覆盖 - 真正安全的做法是：只动
css/custom.css+config.inc.php，其余全部不动
复杂点在于，不同 phpMyAdmin 版本对 CSS 选择器的 class 名有微调（比如 5.2 用 .server-status-chart，5.3 可能加了 js- 前缀），所以写选择器时最好带上 !important，并定期用 DevTools 检查实际渲染的 class 名。
