phpMyAdmin多语言支持依赖核心LanguageManager和翻译函数__(),而非主题；pmahomme主题因所有文本均包裹__(),故可切换语言，而custom-theme若硬编码HTML或未调用__(),则无法实现多语言。
phpMyAdmin 的多语言支持不依赖主题本身，而是由核心的 $cfg['Lang'] 和浏览器 Accept-Language 头共同驱动；所谓“主题不支持多语言”，实际是主题里的静态 HTML/JS 文本硬编码了英文，或未正确调用 __() 翻译函数 —— 这类主题（如某些第三方定制版）本质上是放弃国际化适配的，不能靠改配置解决。
为什么 pmahomme 主题能切语言而 custom-theme 不能？
官方默认主题 pmahomme 所有界面文本都包裹在 __('xxx') 函数中，该函数会查 ./libraries/classes/LanguageManager.php 加载对应 .po/.mo 文件；而很多自定义主题直接写死 <h2>Edit Table</h2>，跳过了翻译流程。即使你把 $cfg['Lang'] = 'zh' 写进 config.inc.php，这类 HTML 字符串也不会被替换。
- 检查主题目录下是否有
lang/子目录，且内含zh.mo或zh_CN.mo文件 - 搜索主题 PHP 模板文件（如
header.php、navigation.php）里是否出现未包裹的纯英文字符串 - 确认主题是否继承自
Theme基类并调用$GLOBALS['PMA_Twig']->render()—— 老式主题直出 HTML 就无法接入翻译管道
如何让非标准主题强制显示中文界面？
绕过主题自身的语言逻辑，直接干预 phpMyAdmin 的语言加载时机。在 config.inc.php 末尾追加：
if (!defined('PMA_MINIMUM_COMMON')) {
define('PMA_MINIMUM_COMMON', 1);
}
require_once './libraries/classes/LanguageManager.php';
$GLOBALS['PMA_lang'] = 'zh';
$GLOBALS['PMA_language'] = 'zh';
$GLOBALS['PMA_lang_name'] = 'Chinese (Simplified)';
但这只影响核心菜单、SQL 提示、错误信息等由 phpMyAdmin 渲染的部分；主题里硬编码的按钮文字、标题仍不会变。
立即学习“PHP免费学习笔记（深入）”；
- 此方式对
pmahomme无效（它本就支持），仅对“半残”主题临时兜底 - 若主题使用 Twig 模板，需额外在
templates/下补全zh.json本地化映射 - 修改后务必清空浏览器缓存和
./tmp/目录下的cache_*文件，否则旧语言包可能被缓存
主题作者没做 i18n，自己补翻译最省事的做法
不重写整个主题，只打补丁：在主题的 index.php 或主入口处，用 str_replace() 替换关键字符串。例如：
ob_start();
include 'original_header.php';
$html = ob_get_clean();
$html = str_replace('Edit table', '编辑数据表', $html);
$html = str_replace('Browse rows', '浏览记录', $html);
echo $html;
这种做法快但脆弱 —— 一旦主题更新，所有 str_replace 都得重验。
- 优先匹配完整 HTML 标签内的文本，避免误替换单词（如只替
>Edit table<，不替Edit table） - 替换内容必须 UTF-8 编码，且不能含 BOM；否则页面头部乱码
- 若主题 JS 动态生成文字（如 AJAX 成功提示），还得 Hook
$.alert()或覆盖PMA_messages对象
真正可靠的多语言适配，必须从主题模板层统一走 __('xxx') + lang/ 目录结构；临时打补丁能应付一时，但只要主题升级或 phpMyAdmin 版本跨大版本（如 5.x → 6.x），这些字符串位置和上下文大概率会变。
