本文介绍如何结合 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" }}
<script>
const translations = JSON.parse(document.getElementById('i18n-translations').textContent);
// 注意：上面会报错 —— 正确写法应统一在单个 JSON 对象中传递
</script>更稳妥的做法是统一构造一个翻译字典：
# views.py
context = {
'i18n_messages': {
'add_to_purchase_list': _("Add to purchase list"),
'recipe_in_purchase_list': _("Recipe in purchase list"),
}
}<!-- your_template.html -->
{{ i18n_messages|json_script:"i18n-messages" }}
<script>
const I18N = JSON.parse(document.getElementById('i18n-messages').textContent);
const configButton = {
purchases: {
attr: 'data-out',
default: {
class: 'button_style_blue',
text: `<span class="icon-plus button__icon"></span>${I18N.add_to_purchase_list}`
},
active: {
class: 'button_style_light-blue-outline',
text: `<span class="icon-check button__icon"></span>${I18N.recipe_in_purchase_list}`
}
}
};
</script>⚠️ 注意事项
- ❌ 不要直接在 .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 接口获取，但服务端模板注入方式最轻量、兼容性最强。
通过该方案，既保持了 JavaScript 配置的清晰结构，又完全复用 Django 的成熟 i18n 生态，实现按钮文案的无缝多语言切换。
