gettext扩展需同时满足加载成功、依赖完备、初始化正确、文件合规四条件：检查phpinfo中enabled及函数列表，补全匹配架构的libintl.dll，执行setlocale/bindtextdomain/textdomain三步初始化，并确保.mo文件路径结构、编码、命名严格符合GNU规范。
确认 gettext 扩展是否真的已加载
很多问题其实卡在「以为开了，其实没开」。XAMPP 自带的 PHP 编译时默认不启用 gettext，即使 php.ini 里解注释了 extension=php_gettext.dll（Windows）或 extension=gettext.so（Linux/macOS），也不代表它能跑起来——缺依赖、路径错、架构不匹配都会导致静默失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 打开
http://localhost/dashboard/phpinfo.php，搜索gettext，确认页面中出现 gettext support => enabled 和相关函数列表（如gettext、dgettext） - 若没出现，别急着改代码，先检查 PHP 错误日志：
xampp\apache\logs\error.log或php_error_log中是否有类似PHP Warning: PHP Startup: Unable to load dynamic library 'php_gettext.dll'的报错 - Windows 下特别注意：XAMPP 32 位版必须用 32 位 DLL，64 位版必须用 64 位 DLL；
php_gettext.dll必须和libintl.dll在同一目录（通常是xampp\php\），且后者不能缺失
Windows 下修复 libintl.dll 缺失或版本冲突
XAMPP 自带的 php_gettext.dll 依赖 libintl.dll，但 XAMPP 安装包通常不附带这个文件，或附带的是旧版（比如 0.17），而新版 PHP（如 8.1+）需要 0.19+ 才能正常调用 bindtextdomain() 等函数，否则会返回 false 且无提示。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 从 mlocati/gettext-windows 下载匹配你 PHP 架构（x86/x64）和版本的
libintl-2.dll，重命名为libintl.dll - 把它放进
xampp\php\目录，并确保php.ini中extension_dir指向该目录（例如extension_dir = "C:\xampp\php\ext"） - 重启 Apache 后，用
var_dump(PHP_BINDIR);确认 PHP 运行时能读到该目录；再执行var_dump(bindtextdomain('messages', 'C:/path/to/locale'));，返回非false才算真正就绪
gettext 函数调用前必须完成的三步初始化
即使扩展加载成功，gettext 仍可能返回原文——这不是 bug，是它严格遵循 GNU gettext 流程。漏掉任意一步，_() 就只是个普通函数，不做翻译。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
-
setlocale(LC_MESSAGES, 'zh_CN.UTF-8')：必须指定 locale 名称，且系统需实际支持该 locale。Windows 下常用Chinese_China.936或zh_CN（取决于系统语言包），可先用var_dump(setlocale(LC_ALL, 0));查看当前可用值 -
bindtextdomain('messages', 'C:/xampp/htdocs/myapp/locale')：第一个参数是 domain 名（对应.mo文件前缀），第二个是包含zh_CN/LC_MESSAGES/messages.mo的父目录路径，路径必须绝对且可读 -
textdomain('messages')：设定默认 domain，之后调用_()才会自动使用它；不设则必须显式用dgettext('messages', 'Hello')
验证 .mo 文件结构与编码是否合规
gettext 对文件路径、命名、编码极其敏感。一个常见的现象是：PHP 不报错，gettext() 返回空字符串或原文，但 msgfmt --check 又说文件没问题——问题往往出在 MO 文件生成环节。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确保 PO 文件保存为 UTF-8 编码（无 BOM），且头部声明
"Content-Type: text/plain; charset=UTF-8\n" - MO 文件必须放在
locale/{lang}/LC_MESSAGES/{domain}.mo结构下，例如locale/zh_CN/LC_MESSAGES/messages.mo；Windows 路径分隔符用正斜杠或双反斜杠，单反斜杠会被 PHP 当作转义 - 用命令行验证：
msgunfmt messages.mo | head -n 20看是否能正确解析出原始字符串；如果报错或输出乱码，说明 MO 文件损坏或编码不一致 - 开发阶段建议开启 debug：在调用前加
putenv('GETTEXT_DEBUG=1');，错误会输出到 Apache 错误日志中
最常被忽略的是 locale 名称与系统实际支持的不一致，以及 libintl.dll 版本和 PHP 运行时 ABI 不兼容——这两点不排查清楚，其他配置全对也白搭。
