使用 Claude Code 实现 i18n Django 自动化

使用 Claude Code 和 GStack 自动化 Django i18n

Claude Code 结合 GStack 技能包，能自动为 Django 项目创建和更新翻译。该工具扫描文件，识别硬编码字符串，生成 i18n 键，并编译消息文件。整个过程只需几分钟，而非手动操作数小时，大幅减少错误并节省令牌消耗。

环境配置

按照说明安装 Claude Code 和 GStack 包。激活 /qa 技能用于本地化任务。确保 settings.py 中设置 USE_I18N = True 并指定 LANGUAGE_CODE。

新增语言时，在 LANGUAGES 中添加：

LANGUAGES = [
    ('en', 'English'),
    ('ru', 'Russian'),
]

实际案例：翻译更新内容

在首页添加文本时，将 /qa 技能指向变更文件，并在提示中说明。例如提示：

将 templates/landing.html 中的所有变更翻译成英语。创建 i18n 键，更新 .po 文件，并运行 compilemessages。

AI 会分析代码并提出计划：

• 扫描文件中静态字符串。
• 生成 gettext 键（例如 msgid "Welcome" → msgctxt "landing.welcome"）。
• 在 django.po 中填充翻译。
• 使用 python manage.py compilemessages 编译。

批准计划后，它会自动执行。

实现细节

该技能自动识别模板和视图中带有 _('text') 或纯字符串的位置。对于多个文件，可列出文件名或指定目录。节省令牌的关键在于精确定位文件路径。

主要优势：

• 自动键生成：避免重复和冲突。
• 上下文感知翻译：根据字符串周边环境提升准确性。
• 无缝集成 makemessages：无需手动运行。
• 可扩展：适用于支持数十种语言的项目。

测试案例中，处理仅需 5 分钟，消耗约 10K 令牌。结果：即用型 locale/en/LC_MESSAGES/django.mo 文件，无需手动调整。

优化工作流程

方法对比

| 方法 | 时间 | 令牌 | 质量 |

|--------|------|--------|---------|

| 手动 makemessages + poedit | 30-60 分钟 | 0 | 一般（人为错误） |

| Claude Code /qa | 5 分钟 | 10K | 高（上下文分析） |

| 全 AI（无路径） | 7 分钟 | 15K | 高 |

适合个人项目或有严格翻译审核的生产环境。

最佳实践

• 明确指定源语言：从俄语翻译到英语。
• 批准前审阅计划。
• 集成到 CI/CD：使用 Claude API 调用脚本。
• 为复杂短语添加上下文：翻译首页问候语。
• 测试渲染：{% load i18n %} {{ _('key') }}。

关键要点

• 自动化减少 90% 重复工作，让你专注编码。
• /qa 技能可独立运行 Django 命令。
• 中高级开发者节省翻译人力。
• 支持多语言的大型项目扩展。
• 细微之处（如习语、格式）仍需人工审核。

— Editorial Team