必须修改 themes/darkblue/css/theme.css 文件，因主色调硬编码在其中；同时需同步更新 theme.json 的 name 和 version 字段，并调整 codemirror.css 等配套样式。
主题配色修改必须改 themes/darkblue/css/theme.css，不是 config.inc.php
很多人以为改 $cfg['themedefault'] 或加 css 变量就能换主色调，其实 phpmyadmin 的主题配色逻辑是静态编译进 css 文件的。官方 darkblue 主题的主色（比如顶部栏、按钮、选中行）全部定义在 themes/darkblue/css/theme.css 里，且大量使用硬编码的 #1a5c9e 这类值，不走 css 自定义属性。
实操建议：
- 先备份原
themes/darkblue/css/theme.css，避免升级覆盖 - 不要试图用
<style></style>标签或用户 CSS（$cfg['UserCss']）覆盖关键选择器——z-index、background-image、border-color 等会被优先级更高的原始规则压住 - 重点搜索替换以下几组颜色值：
#1a5c9e（主蓝）、#2775c8（hover 蓝）、#000（深色文字）、#fff（浅色背景） - 改完后清空浏览器缓存，phpMyAdmin 不会自动刷新 CSS 版本号
测试/生产环境区分：靠 theme.css 文件名 + $cfg['ThemeDefault'] 动态切换
硬编码改同一份 CSS 无法实现环境隔离。正确做法是复制一份主题，重命名目录并修改配置指向它。比如为测试环境建 themes/darkblue-test，把改过的 theme.css 放进去，再在对应环境的 config.inc.php 里设：
$cfg['ThemeDefault'] = 'darkblue-test';
常见错误现象：
- 复制主题目录但漏改
theme.json里的"name"字段 → phpMyAdmin 启动时报错Theme not found - 没改
theme.json中的"version"→ 浏览器可能复用旧 CSS 缓存，配色不生效 - 用 symlinks 指向同一份 CSS → 两个环境配色同步变化，失去区分意义
按钮和表头颜色改了但 SQL 执行框还是默认蓝？查 .CodeMirror 和 .syntaxhighlighter 类
主色调修改容易忽略编辑器区域。SQL 查询框、结构页字段列表、JSON 查看器等用的是 CodeMirror 或 syntaxhighlighter，它们的颜色独立于主题 CSS，定义在：
-
themes/darkblue/css/codemirror.css（控制.CodeMirror背景、行号、关键字色） -
themes/darkblue/css/syntaxhighlighter.css（影响.syntaxhighlighter的高亮块）
例如，把 SQL 关键字从默认蓝改成橙红，要改 .cm-keyword { color: #d32f2f !important; }；否则即使顶部栏变成绿色，执行框里仍是刺眼的蓝底白字。
PHP 8.2+ + phpMyAdmin 5.2.x 下自定义主题可能触发 Undefined array key "name"
新版 phpMyAdmin 加强了主题元数据校验。如果只复制目录、改 CSS 却没补全 theme.json 必填字段，页面可能空白，PHP 错误日志里出现：
PHP Warning: Undefined array key "name" in /path/to/phpmyadmin/libraries/classes/Theme.php
必须确保 theme.json 至少包含：
{
"name": "darkblue-test",
"version": "1.0.0",
"description": "Test environment theme with green accent"
}
少一个字段，整个主题加载失败，回退到默认 white 主题，配色修改完全不生效。
改主题不是换张皮肤，而是动了它的渲染链路核心。最常被跳过的其实是 theme.json 版本号更新和 CodeMirror 样式同步——这两处一漏，前面所有颜色替换都白忙。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
