SQL历史记录的样式究竟由哪个CSS文件控制？许多人在调整phpMyAdmin 5.x的查询历史记录显示效果时，都会遇到这个困惑。实际上，sql历史记录（也就是「sql查询」标签页下方那个history区域）的渲染主要依赖js/dist/history.js动态生成DOM，但最终的视觉呈现还是要靠templates/sql/history.twig模板以及全局CSS文件css/common.css中的几个关键类——.history-entry、.history-query、.history-time。直接修改common.css确实最直接、最有效，但在phpMyAdmin升级时会被覆盖，这是最大的隐患。
如何安全地覆盖默认历史记录样式，避免升级丢失？
既然直接改common.css存在风险，推荐的做法是通过自定义主题来注入CSS，从而安全覆盖phpMyAdmin默认样式。具体操作并不复杂：
- 在
config.inc.php中启用自定义主题支持，添加$cfg['ThemePath'] = 'themes';，并确认该目录已存在。 - 新建一个目录
themes/custom/，然后将任意一个内置主题（比如themes/pmahomme/theme.css）复制一份到该目录下，作为自定义主题的基础。 - 打开复制过来的
theme.css，在末尾追加你想要的覆盖规则。例如：.history-entry { padding: 6px 10px; border-bottom: 1px solid #eee; }.history-query { font-family: 'SFMono-Regular', Consolas, monospace; font-size: 0.9em; }.history-time { color: #666; font-size: 0.8em; } - 最后在
config.inc.php中指定主题：$cfg['ThemeDefault'] = 'custom';
这套流程的好处是：即使用户升级phpMyAdmin，自定义主题文件也不会被覆盖，所有样式改动都可以长期保留，无需每次重复配置。
为什么改了CSS但历史记录显示没变化？常见原因排查
不少人折腾完发现没效果，无非是以下几个原因导致的：
- 浏览器缓存了旧的
theme.css或common.css。强制刷新一下试试（Ctrl+Shift+R），或者直接清空浏览器缓存，确保加载到最新版本。 - 主题没对上：你修改的是
themes/pmahomme/theme.css，但当前实际启用的主题并不是pmahomme。请检查$cfg['ThemeDefault']的实际值，确保与你修改的那个主题保持一致。 - 样式优先级不够：某些更具体的选择器（比如
.history-entry .history-query）的优先级会高于单独的.history-query。你可以适当提高权值，或者临时用!important来做调试确认（不建议在生产环境长期使用!important，以免影响后续维护）。
能否只对历史查询中的SELECT语句做高亮显示？
纯CSS这条路走不通，因为phpMyAdmin并没有给不同SQL类型分配不同的class。想要实现这个效果，必须修改JavaScript逻辑：
- 找到
js/dist/history.js（或者源码中的js/src/history.js） - 定位到渲染单条记录的函数（通常是
appendHistoryEntry或类似名称） - 在拼接HTML字符串之前，用正则判断SQL语句类型：
if (/^\s*select\b/i.test(query)) { classes += ' history-select'; } - 然后在你的
theme.css里加上专属样式，比如.history-select .history-query { background: #f0f9ff; }
不过需要提醒的是：这种JS层面的修改在phpMyAdmin升级时会丢失，而且可能需要重新构建前端资源（npm run build）。生产环境要谨慎使用，除非你愿意维护一个补丁包，确保每次升级后都能同步更新。
