如何在 Django 中实现前端按钮文本的国际化翻译

碧海醫心 2026-01-21 00:00:00 次阅读

本文介绍如何结合 django 内置 i18n 机制，为 javascript 中定义的按钮文案（如 vue/react 或纯 js 配置对象）添加多语言支持，重点解决静态 js 对象内文本的可翻译性问题。

在 Django 构建的多语言网站中，后端模板（.html）中的文本可通过 {% trans %} 或 gettext 轻松翻译，但前端 JavaScript 中硬编码的字符串（如按钮配置对象）默认无法被 makemessages 扫描识别，因此需采用“服务端预渲染 + 客户端注入”的方式实现国际化。

核心思路是：将待翻译的文本在 Python 视图或模板上下文中提前翻译好，并通过安全方式传递给前端 JavaScript。以下是推荐的实践步骤：

✅ 步骤一：在视图中准备翻译后的文本

在对应的视图（如 views.py）中导入并调用 gettext：

from django.utils.translation import gettext as _

def your_view(request):
    context = {
        'add_to_purchase_list': _("Add to purchase list"),
        'recipe_in_purchase_list': _("Recipe in purchase list"),
    }
    return render(request, 'your_template.html', context)

✅ 步骤二：在模板中安全注入翻译文本到 JS

在 HTML 模板（如 your_template.html）中，使用 json_script 过滤器将翻译结果序列化为 JSON 并嵌入页面（避免 XSS 风险）：

{{ add_to_purchase_list|json_script:"i18n-translations" }}

更稳妥的做法是统一构造一个翻译字典：

# views.py
context = {
    'i18n_messages': {
        'add_to_purchase_list': _("Add to purchase list"),
        'recipe_in_purchase_list': _("Recipe in purchase list"),
    }
}


{{ i18n_messages|json_script:"i18n-messages" }}

⚠️ 注意事项

❌ 不要直接在 .js 文件中调用 gettext —— 静态 JS 文件不
经过 Django 模板引擎，_() 不会被执行，也无法触发 makemessages 提取；
✅ 确保已启用 Django 国际化中间件（'django.middleware.locale.LocaleMiddleware'）并正确配置 LANGUAGES 和 USE_I18N = True；
✅ 运行 python manage.py makemessages -l en -l zh_Hans 生成 .po 文件，并完成翻译后执行 compilemessages；
✅ 若项目使用构建工具（如 Webpack/Vite），也可考虑将翻译数据作为全局变量注入或通过 API 接口获取，但服务端模板注入方式最轻量、兼容性最强。