WordPress 新增文章分类标签多语言前置翻译流程（Polylang 总数校验+标签脚本复制避坑）

前言：承接本系列第6篇《第5篇：WordPress 多语言博客翻译实操全记录（Polylang 插件，附避坑指南）》，第6篇聚焦「存量中文博客全文翻译为英文」的完整流程，而实际运营中，我们会持续新增中文文章——这些新增文章会伴随新的分类、新的标签，若直接翻译文章正文，会出现分类/标签语言错乱、关联失效、前台显示异常等问题。本篇核心解决「新增中文文章多语言翻译前置准备」，重点讲解：新增分类/标签的前置翻译逻辑、标签脚本复制技巧、分类手动翻译方法，以及用「总数校验」快速排查漏译的极简技巧，全程结合 Polylang 插件实操，附截图（精准标注占位场景），帮你避开所有前置翻译的坑。

一、前置认知：为什么新增文章，必须先译分类标签，再译正文？

核心逻辑：WordPress 多语言站点（Polylang插件）中，分类、标签属于「全局属性」，文章与分类/标签是「关联绑定」关系。若先翻译文章正文，再补充分类/标签的英文翻译，会导致：

– 文章无法正常关联英文分类/标签，前台英文站点显示「无分类」「无标签」；

二、前置准备：Polylang 插件基础配置检查（确保分类标签可正常翻译，）
在开始新增分类/标签翻译前，需先确认 Polylang 插件配置无误，避免因基础设置问题导致翻译失败，重点检查3个核心设置（承接第6篇配置，补充新增场景所需）。
2.1 确认中英文语言已正常添加
操作路径：WordPress后台 → Polylang → 语言 → 确认「中文（简体）」「English（United States）」已添加，且默认语言为中文（与新增文章语言一致）。
配图说明（如图2）：Polylang 语言管理页面截图，标注中英文语言条目、默认语言设置位置。

2.2 同步设置优化（贴合实操，补充文章格式勾选疑问）
操作路径：WordPress后台 → Polylang → 设置 → 同步，同步选项包含：分类法、自定义字段、评论状态、Ping状态、置顶文章、发布日期、文章格式、父级页面、页面模板、页面顺序、特色图片（注意：同步选项中无「标签」选项）。实操发现，无需勾选其他同步选项，翻译文章时，分类与标签会自动同步关联，英文文章会自动匹配对应中文文章的分类和标签，无需手动操作，这是 Polylang 插件的默认特性——创建新译文时会自动复制源文章的分类、标签等元数据。因此同步设置优先勾选「发布日期」，确保中英文文章发布日期一致；针对经典编辑器格式不一致的问题，经实操验证，勾选「文章格式」同步选项后，新翻译的英文文章（无论使用经典编辑器还是Gutenberg编辑器），均可与中文源文章格式保持一致，彻底解决经典编辑器格式错乱问题，无需额外测试，直接勾选即可，不会影响站点其他配置。
配图说明（如图3）：Polylang 同步设置页面截图，标注同步选项完整列表（无标签选项），明确标注「发布日期」「文章格式」两个必勾选位置，说明勾选后可实现的效果（日期一致、格式统一），无需测试直接操作即可。

三、核心实操：新增标签翻译（无需手动逐条补全，PHP 脚本辅助校验复制）
核心规则：新增中文标签，英文版本 无需人工翻译 ，直接原样复制中文标签名称（避免翻译后标签语义偏差、用户搜索不匹配）。实操中可借助 PHP 脚本辅助操作，该脚本可在服务器中运行，核心功能为：查询出所有中文语言下的标签，自动校验是否有对应的英文翻译，若没有则自动复制中文标签作为英文标签补全，无需手动检索或批量操作，高效且精准。示例：新增中文文章标签列表为「ColorOS、Google 账号安全验证、安全码、GMS、安全性与登录、登录Google、Google移动服务、Google服务框架、一加12、OnePlus 12」，可通过该脚本快速完成英文标签补全。
3.1 第一步：新增中文标签并记录（基础准备）
操作路径：新增中文文章时，在文章编辑页的「标签」输入框中，添加对应标签（如示例中的「ColorOS、Google 账号安全验证」等），添加完成后保存文章。无需手动记录标签，后续脚本会自动查询所有中文标签，无需额外操作。
配图说明（如图1）：WordPress文章编辑页「标签」输入框截图。

3.2 第二步：运行 PHP 脚本，自动校验并补全英文标签
操作步骤（脚本运行相关）：
3.2.1. 第一步：准备 PHP 脚本（自行编写或获取），确认脚本可正常运行，核心功能为「查询中文标签、校验英文标签、自动复制补全」；

polylang-batch-zh-to-en-tags.php

<?php
if (php_sapi_name() !== 'cli') {
    die("❌ 请在命令行运行\n");
}

require __DIR__ . '/wp-config.php';
global $wpdb, $polylang;

// 配置：一次处理多少个，你可以根据自己的服务器调整
$per_page = 1000; 
// 配置：源语言和目标语言，以后其他语言直接改这里就好
$source_lang = 'zh';
$target_lang = 'en';

echo "🚀 开始批量处理所有{$source_lang}标签，自动添加{$target_lang}翻译（分页模式）...\n\n";

$processed = 0;
$skipped = 0;
$offset = 0;

while (true) {
    // 分页拿源语言标签
    $terms = get_terms([
        'taxonomy' => 'post_tag',
        'lang' => $source_lang,
        'hide_empty' => false,
        'number' => $per_page,
        'offset' => $offset,
    ]);

    if (is_wp_error($terms) || empty($terms)) {
        break;
    }

    $current_count = count($terms);
    echo "📊 正在处理第 " . ($offset + 1) . " - " . ($offset + $current_count) . " 个标签...\n";

    foreach ($terms as $term) {
        $source_id = $term->term_id;
        $name = $term->name;
        $slug = $term->slug;

        // 检查是不是已经有目标语言的翻译了
        $target_id = pll_get_term($source_id, $target_lang);
        if ($target_id) {
            $skipped++;
            continue;
        }

        echo "🔰 正在处理: {$name} (ID: {$source_id})\n";

        // 创建目标语言标签，绕过slug重复检查
        $wpdb->insert($wpdb->terms, [
            'name' => $name,
            'slug' => $slug,
            'term_group' => 0
        ]);
        $new_target_id = $wpdb->insert_id;

        // 目标语言标签的taxonomy
        $wpdb->insert($wpdb->term_taxonomy, [
            'term_id'     => $new_target_id,
            'taxonomy'    => 'post_tag',
            'description' => '',
            'parent'      => 0,
            'count'       => 0
        ]);

        // 设置目标语言
        $polylang->model->term->set_language($new_target_id, $target_lang);

        // 绑定翻译
        $polylang->model->term->save_translations($source_id, [
            $target_lang => $new_target_id
        ]);

        $processed++;
    }

    $offset += $per_page;
    unset($terms);
    gc_collect_cycles();
}

echo "\n🎉 全部处理完成！\n";
echo "📊 统计：\n";
echo "   已处理新标签: {$processed}\n";
echo "   已跳过已有翻译: {$skipped}\n";
echo "\n✅ 所有标签都已经处理完毕，和手动添加的完全一样！\n";

3.2.2. 第二步：将 PHP 脚本上传至 WordPress 站点对应的服务器目录（确保脚本拥有对应运行权限，避免运行失败）；

3.2.3. 第三步：在服务器中运行该 PHP 脚本，等待脚本执行完成（执行时间根据标签数量而定，标签数量少则秒级完成）；

3.2.4. 第四步：脚本执行完成后，进入 WordPress 后台，无需手动操作，脚本已自动补全所有未同步的英文标签。

如图4：中文/英文标签管理页面分屏对比截图，标注两者总数差异，演示「英文总数＜中文总数」的场景，明确需要补全新增标签；

核心操作：将准备好的 PHP 脚本上传至服务器，在服务器中运行该脚本，脚本会自动执行以下操作，无需人工干预：1. 查询所有中文语言下的标签（包含刚新增的文章标签）；2. 逐一校验每个中文标签，确认英文语言下是否有对应的同名标签（无需翻译，直接匹配名称）；3. 若检测到英文语言下无对应标签，脚本会自动复制该中文标签，作为英文标签添加到英文标签列表中，完成补全。

3.3 第三步：标签同步后校验（确保无遗漏）

操作路径：WordPress后台 → 文章 → 标签 → 切换到英文语言（顶部语言切换按钮），查看同步后的标签数量和名称，确认与中文新增标签完全一致。

配图说明（共2张）：

3.3.1. 如图5：服务器中运行PHP脚本的界面截图，标注脚本运行命令、执行状态（如「正在处理」「处理完成」），以及脚本执行成功的提示信息；

[root@iZ23wv7v5ggZ www.shuijingwanwq.com]# php polylang-batch-zh-to-en-tags.php
🚀 开始批量处理所有zh标签，自动添加en翻译（分页模式）...

📊 正在处理第 1 - 1000 个标签...
📊 正在处理第 1001 - 2000 个标签...
🔰 正在处理: ColorOS (ID: 35286)
📊 正在处理第 2001 - 3000 个标签...
🔰 正在处理: GMS (ID: 35292)
🔰 正在处理: Google服务框架 (ID: 35300)
🔰 正在处理: Google移动服务 (ID: 35298)
📊 正在处理第 3001 - 4000 个标签...
🔰 正在处理: OnePlus 12 (ID: 35302)
📊 正在处理第 4001 - 5000 个标签...
📊 正在处理第 5001 - 6000 个标签...
📊 正在处理第 6001 - 7000 个标签...
🔰 正在处理: 安全性与登录 (ID: 35294)
🔰 正在处理: 安全码 (ID: 35290)
📊 正在处理第 7001 - 8000 个标签...
🔰 正在处理: 登录Google (ID: 35296)
🔰 正在处理: 账号安全验证 (ID: 35288)
📊 正在处理第 8001 - 8069 个标签...

🎉 全部处理完成！
📊 统计：
   已处理新标签: 9
   已跳过已有翻译: 8060

✅ 所有标签都已经处理完毕，和手动添加的完全一样！

3.3.2. 如图6：脚本执行完成后，英文标签管理页面截图，标注自动补全的标签列表，确认与中文新增标签完全一致，无需手动补全。

四、核心实操：新增分类翻译（需手动译，提前检索+录入）
核心规则：分类与标签不同，需体现站点栏目层级和英文语义准确性，不能直接复制中文 ，需手动翻译（建议参考行业英文规范，避免直译导致的语义偏差），且需提前在 Polylang 后台检索，确认该分类未被翻译后，再进行录入。
4.1 第一步：记录新增中文分类（精准定位，避免漏译）
配图说明（如图1）：WordPress文章编辑页「分类」输入框截图。

4.2 第二步：检索分类是否已翻译（关键步骤，避免重复翻译）
操作路径：WordPress后台 → Polylang → 分类 → 切换到英文语言 → 在「搜索框」中输入中文分类名称（或翻译后的英文名称），检索是否存在对应分类：
– 若检索到，说明该分类已翻译，无需重复操作；
– 若未检索到，说明该分类未翻译，需进行下一步手动翻译录入。
配图说明（如图7）：Polylang 分类管理页面截图，标注语言切换按钮、搜索框，以及「未检索到结果」的提示（对应未翻译分类场景）。

4.3 第三步：手动翻译并录入英文分类（规范操作，避免错乱）
操作步骤：
1. 在 Polylang 分类管理页面（中文语言），点击「+」；
2. 录入翻译后的英文分类名称（需贴合中文语义，参考行业规范，例如「技术教程」译为「Tech Tutorials」，而非直译「Technology Course」）；
3. 复制中文分类的描述（若有），翻译后录入英文分类描述（保持语义一致，简洁明了）；
4. 在「关联」下拉框中，选择对应的中文分类（实现中英文分类关联，避免关联失效）；
5. 点击「添加分类」，完成英文分类录入。
配图说明（共2张）：
1. 如图8：英文分类「添加分类」页面截图，标注英文名称、描述录入位置，以及「关联」下拉框的选择方法；

2. 如图9：添加完成后的英文分类列表截图，标注关联的中文分类，确认录入成功。

4.4 第四步：分类翻译后校验（确保关联正确）
操作路径：切换回中文分类管理页面，找到新增分类，查看「语言」列，确认已显示对应的英文分类（说明关联成功）；同时切换到英文分类页面，确认分类名称、描述无误。
配图说明（如图9）：中文分类管理页面截图，标注「语言关联」显示位置，确认英文分类已关联成功。

五、极简避坑技巧：用「总数校验」快速排查漏译（核心高效）
无需逐条核对每个分类、标签，只需通过「中文/英文分类总数、标签总数对比」，就能快速判断是否有新增条目漏译/漏同步，适合批量新增场景，节省大量核对时间。
5.1 分类总数校验方法
操作路径：
1. WordPress后台 → 文章 → 分类 → 切换到中文语言，查看分类总数（标注为「中文分类数」）；
2. 切换到英文语言，查看英文分类总数（标注为「英文分类数」）；
3. 对比两个总数：若数量一致，说明无漏译；若英文分类数少于中文，说明有新增中文分类未翻译，补齐即可。
配图说明（如图10）：中文、英文分类管理页面截图（分屏对比），标注两个页面的分类总数，演示数量一致/不一致的场景。

5.2 标签总数校验方法
操作路径与分类一致：
1. WordPress后台 → 文章 → 标签 → 切换到中文语言，查看标签总数；
2. 切换到英文语言，查看英文标签总数；
3. 对比两个总数：若数量一致，说明脚本同步成功，无漏同步；若英文标签数少于中文，说明脚本同步失败，重新执行脚本即可。

六、总结：新增文章多语言翻译完整流程（极简版）

结合本篇实操，整理新增中文文章多语言翻译的完整前置+正文流程，可直接对照操作，高效不出错：

1. 新增中文文章，确定文章分类、标签（记录新增分类/标签）；

2. 前置操作1：新增标签 → 用脚本一键同步到英文（同步后校验总数）；

3. 前置操作2：新增分类 → 手动翻译 → 检索未翻译分类 → 录入英文分类并关联中文分类（录入后校验关联和总数）；

4. 后置操作：翻译文章正文（参考第6篇实操），关联已翻译的英文分类/标签，发布英文译文。