WordPress插件国际化遇阻：文本域加载失败求解决方案

针对你遇到的load_plugin_textdomain返回false、翻译不生效的问题，从以下几个方向逐一排查：

1. 翻译文件命名与字符串匹配错误（最常见原因） #

• 文件名规范问题：WordPress要求翻译文件命名格式为{文本域}-{语言代码}.mo，你的文本域是phpp，所以西语文件必须命名为phpp-es_ES.mo（而非你当前的es_ES.mo），否则WordPress无法识别关联到你的插件文本域。
• 字符串大小写/格式不匹配：你代码中使用的是_e('Hello world', 'phpp')（小写w），但po文件里的msgid是"Hello World"（大写W），两者完全一致才能匹配生效，修正po文件中的msgid为"Hello world"后重新编译mo文件。

2. 文本域加载路径的可靠写法 #

替换你当前的路径写法，使用更稳定的plugin_dir_path函数构建绝对路径：

function phpp_load_textdomain() {
    $loaded = load_plugin_textdomain(
        'phpp',
        false,
        plugin_dir_path(__FILE__) . 'languages/'
    );
    error_log($loaded ? '文本域加载成功' : '文本域加载失败');
}
add_action('plugins_loaded', 'phpp_load_textdomain');

plugin_dir_path(__FILE__)会直接输出插件根目录的绝对路径，避免plugin_basename可能带来的路径拼接错误。

3. 验证翻译文件有效性 #

• 用Poedit重新打开po文件，确认所有msgid与代码中__()/_e()里的字符串完全一致（包括空格、标点、大小写），然后重新编译生成mo文件。
• 临时添加gettext过滤器测试文本域是否正常工作：

add_filter('gettext', function($translation, $text, $domain) {
    if ($domain === 'phpp' && $text === 'Hello world') {
        return 'Hola Mundo';
    }
    return $translation;
}, 10, 3);

如果页面能显示Hola Mundo，说明文本域加载正常，问题出在mo文件本身。

4. 环境与权限排查 #

• 确认后台「设置→常规→站点语言」确实设置为「西班牙语（Español）」，对应语言代码es_ES。
• 检查languages文件夹及phpp-es_ES.mo文件的权限：文件夹设为755，文件设为644，确保Web服务器有权读取。
• 临时禁用其他插件，排查是否有插件干扰文本域加载。

5. 开启调试查看详细错误 #

在wp-config.php中开启调试模式：

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

查看wp-content/debug.log中的日志，会显示加载mo文件时的具体错误（比如文件不存在、路径错误等），帮助定位问题。

内容的提问来源于stack exchange，提问作者Maramal