phpMyAdmin 5.x修改SQL历史查询记录显示样式

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）。生产环境要谨慎使用，除非你愿意维护一个补丁包，确保每次升级后都能同步更新。