phpMyAdmin多语言失效主因是gettext扩展未启用或配置错误：需在php.ini中启用extension=gettext、删除$cfg['Lang']强制赋值、确保UTF-8编码及中文字体安装，并验证gettext函数可用性。
phpMyAdmin 多语言失效，gettext 扩展没加载
多数情况下，界面仍为英文，不是配置错了，而是 gettext 根本没启用。lamp 默认不开启该扩展，尤其 ubuntu/debian 的 php-gettext 包已废弃，不能靠 apt install php-gettext 解决。
实操建议：
- 确认 PHP 版本（如
php -v），再查对应php.ini路径（php --ini） - 编辑
php.ini，取消注释或添加：extension=gettext（注意：不是php-gettext，也不是gettext.so路径） - 重启 Web 服务：
sudo systemctl restart apache2或sudo service httpd restart - 用
php -m | grep gettext验证是否在已启用模块列表中
phpMyAdmin 语言设置被 $cfg['Lang'] 强制覆盖
即使 gettext 已就位，如果 config.inc.php 里写了 $cfg['Lang'] = 'en';，它会跳过浏览器语言协商，直接锁定英文。
实操建议：
- 检查
/etc/phpmyadmin/config.inc.php或/usr/share/phpmyadmin/config.inc.php中是否存在$cfg['Lang']赋值 - 删掉这行，或改成
$cfg['Lang'] = '';（空字符串表示自动检测） - 确保
$cfg['AllowArbitraryServer']等安全相关配置不影响会话初始化（语言依赖 session） - 浏览器访问时清空 phpMyAdmin 相关 cookie，避免旧语言缓存干扰
中文等非拉丁语系语言显示为方块或乱码
这不是 gettext 问题，而是字体和字符集未对齐。phpMyAdmin 的 UI 文本由 PHP 渲染 HTML，但浏览器最终渲染依赖系统字体支持和响应头声明。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 确认 Apache 返回的
Content-Type包含charset=utf-8（可通过浏览器开发者工具 > Network > Response Headers 查看） - 在
config.inc.php中显式设置：$cfg['DefaultCharset'] = 'utf-8'; - Linux 服务器需安装中文字体（如
fonts-dejavu或fonts-wqy-zenhei），否则终端或 GUI 环境下 PHP 生成的 PDF/导出文件可能缺字 - 避免在
config.inc.php中使用 GBK 编码保存文件——必须用 UTF-8 无 BOM 编码保存
升级后多语言突然失效，gettext 模块被禁用
PHP 升级（如从 7.4 到 8.1）或系统更新后，php.ini 可能重置，或扩展名变更（如旧版叫 gettext.so，新版路径或名称不同）。
实操建议：
- 运行
php -i | grep "Loaded Configuration File"确认当前生效的php.ini - 执行
php -r "print_r(get_loaded_extensions());"，看gettext是否在输出列表里 - 若不在，用
find /usr -name "*gettext*" 2>/dev/null找扩展文件，再在php.ini中写绝对路径（如extension=/usr/lib/php/20220829/gettext.so） - Apache 使用
libapache2-mod-php时，CLI 和 Web 的 PHP 配置可能不同，务必分别验证
最常被忽略的是：phpMyAdmin 的语言切换依赖完整可用的 gettext + 正确的 LC_MESSAGES 环境（尤其在容器或最小化系统中），而不仅仅是 PHP 扩展开启。别只盯着 config 文件改，先确保 php -r "echo gettext('Welcome');" 能返回翻译结果。
