如何在Wagtail 2.10.X中批量本地化并翻译7000个已有页面？

直接操作SQL确实不可取——Wagtail的页面采用多表继承结构，不同页面类型对应独立数据表，再加上Locale关联、自动生成的slug、页面路径、版本记录等依赖关系，手动SQL极易破坏数据一致性，导致页面无法正常加载或后台管理异常。以下是官方支持的安全批量处理方案：

核心思路：使用Wagtail本地化API #

Wagtail自带的copy_for_translation()方法会自动处理所有关联字段、本地化slug生成、Locale绑定等逻辑，完全规避手动SQL的风险。

1. 前置检查 #

确保项目已启用本地化支持：

• 项目settings.py中设置WAGTAIL_I18N_ENABLED = True
• 配置目标语言到LANGUAGES列表
• 所有需要本地化的页面模型已继承TranslatableMixin（若之前未添加，需先执行迁移）

2. 批量处理脚本示例 #

可以通过Django Shell执行，或编写自定义管理命令（适合重复执行）：

from wagtail.core.models import Page, Locale
# 导入你项目中所有自定义页面类型
from your_app.models import ArticlePage, BlogPage, ProductPage

# 定义源语言和目标语言Locale
source_locale = Locale.get_default()
target_locale = Locale.objects.get(language_code="zh-cn")  # 替换为你的目标语言码

# 获取所有未生成目标语言版本的源语言页面
pages_to_translate = Page.objects.filter(locale=source_locale).exclude(
    translations__locale=target_locale
)

# 分批处理避免内存溢出，每批处理100个页面
batch_size = 100
total = pages_to_translate.count()

for batch_start in range(0, total, batch_size):
    batch = pages_to_translate[batch_start:batch_start+batch_size]
    for page in batch:
        # 创建本地化副本，自动处理关联字段、slug等
        translated_page = page.copy_for_translation(target_locale)
        
        # 【可选】调用翻译API自动填充字段内容
        # 示例：翻译标题和正文（需自行实现translate函数）
        # translated_page.title = translate(page.title, source_locale.language_code, target_locale.language_code)
        # for block in translated_page.body:
        #     if block.block_type == "rich_text":
        #         block.value = translate(block.value, source_locale.language_code, target_locale.language_code)
        
        # 保存本地化页面
        translated_page.save()
        
        # 【可选】自动发布（若原页面已发布）
        # if page.live:
        #     translated_page.save_revision().publish()

3. 关键注意事项 #

• 分批处理：7000个页面一次性处理会占用大量内存，按批次处理更稳妥
• StreamField翻译：如果页面包含StreamField，需要遍历块类型逐个翻译内容
• 发布状态：copy_for_translation()生成的页面默认是草稿状态，需手动发布或通过代码自动发布
• 数据备份：执行批量操作前务必备份数据库，避免意外数据损坏

内容的提问来源于stack exchange，提问作者Some-one