如何检查WordPress(WooCommerce)子主题当前使用的.mo语言文件

我完全懂你这种摸不着头绪的感觉——明明按步骤配置了翻译文件、选了站点语言，可就是看不到效果，关键还不知道怎么确认系统到底有没有加载你准备的.mo文件。下面给你一套落地的排查方案，先解决「怎么看加载情况」，再搞定常见的坑：

一、先搞清楚：当前到底加载了哪个.mo文件？ #

方法1：用调试代码直接输出加载信息 #

在你的子主题functions.php里加这段调试代码（记得替换成你的实际文本域）：

// 注意优先级设为11，确保在你的my_child_theme_setup之后执行
add_action( 'after_setup_theme', 'debug_child_theme_textdomain', 11 );
function debug_child_theme_textdomain() {
    global $l10n;
    // 替换成你在load_child_theme_textdomain里用的文本域
    $your_textdomain = 'my-child-theme';
    
    if ( isset( $l10n[$your_textdomain] ) ) {
        echo '<pre style="background:#f5f5f5; padding:10px;">';
        // 输出翻译对象的详细信息，重点看filename属性
        var_dump( $l10n[$your_textdomain] );
        echo '</pre>';
    } else {
        echo '<p style="color:red;">⚠️ 文本域 ' . $your_textdomain . ' 未被加载</p>';
    }
}

访问你的网站前端，就能看到输出的调试信息，其中filename字段会显示系统实际加载的.mo文件路径——这下就能确认是不是你子主题里的文件被用上了。调试完记得删掉这段代码哦！

方法2：用WordPress调试日志查记录 #

打开wp-config.php，开启调试日志（只在开发环境用，生产环境记得关掉）：

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false ); // 不在前端显示错误，只写入日志

访问网站后，去wp-content/debug.log文件里搜索你的文本域或者.mo文件名，就能找到类似这样的日志：

Loaded textdomain 'my-child-theme', file: '/wp-content/themes/my-child/languages/my-child-theme-zh_CN.mo'

如果是加载失败，日志里会明确提示找不到文件的路径，帮你定位问题。

二、翻译不生效的常见坑，逐一排查 #

确认了加载情况后，如果还是没效果，检查这几个点：

• 文本域必须完全匹配：load_child_theme_textdomain里的文本域，要和你的.mo文件名完全一致。比如文本域是my-child-theme，那.mo文件得是my-child-theme-zh_CN.mo（zh_CN是你选的站点语言代码）。
• 加载函数的路径别写错：子主题的languages目录路径要用get_stylesheet_directory()（指向子主题），别用get_template_directory()（那是父主题的）。正确的写法应该是：

  load_child_theme_textdomain( 'my-child-theme', get_stylesheet_directory() . '/languages' );
  

• 站点语言和文件语言代码要对应：后台「设置-常规」里的站点语言，要和.mo文件的语言代码完全匹配。比如你用的是zh_CN.mo，就必须选「中文（简体）」，不能选其他变体。
• 清缓存！清缓存！清缓存！：不管是缓存插件（WP Rocket、W3 Total Cache这类）还是服务器自带的缓存，都要彻底清除——很多时候翻译不生效就是旧缓存在捣乱。
• 确认.mo文件本身有效：用Poedit打开你的.po/.mo文件，检查要翻译的字符串有没有正确添加、编译。别手动修改.mo文件，一定要用Poedit保存自动生成。

三、终极测试：强制加载指定.mo文件 #

如果上面的方法都没解决，可以试试直接指定文件路径加载，排除路径匹配的问题：

add_action( 'after_setup_theme', 'my_child_theme_setup' );
function my_child_theme_setup(){
    $textdomain = 'my-child-theme';
    $locale = determine_locale(); // 获取当前站点设置的语言代码
    $mo_file_path = get_stylesheet_directory() . '/languages/' . $textdomain . '-' . $locale . '.mo';
    
    if ( file_exists( $mo_file_path ) ) {
        // 强制加载指定的.mo文件
        load_textdomain( $textdomain, $mo_file_path );
    } else {
        // 加载失败的话，日志里会记录路径，方便排查
        error_log( '子主题翻译文件未找到：' . $mo_file_path );
    }
}

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