Django中blocktranslate内变量无法翻译的问题咨询

问题场景 #

模板代码：

<button class="btn">{% blocktranslate %}{{ greeting }} Quy!{% endblocktranslate %}</button>

变量greeting的值为hello，已配置LANGUAGE_CODE = 'vi'，中间件顺序正确，且开启了USE_I18N = True。运行makemessages -l vi生成的.po文件msgid为%(greeting)s Quy!，手动添加msgid "hello"并设置对应msgstr后，编译消息并运行项目，页面仍显示hello而非预期的翻译内容。

原因解析 #

1. blocktranslate标签的作用限制：blocktranslate仅负责翻译包含变量占位符的整段固定文本，不会自动翻译变量本身的内容。它的工作逻辑是先翻译%(greeting)s Quy!这段模板文本，再将变量greeting的原始值插入到翻译后的文本中，因此你手动添加的msgid "hello"不会被该标签触发匹配。
2. 变量未经过翻译处理：传入模板的greeting是原始字符串hello，没有经过Django的翻译流程处理，自然不会被替换为翻译后的内容。

解决方法 #

方法一：在模板中单独翻译变量 #

修改模板代码，对变量单独使用{% trans %}标签：

<button class="btn">{% blocktranslate %}{% trans greeting %} Quy!{% endblocktranslate %}</button>

执行django-admin makemessages -l vi后，.po文件会自动提取hello作为msgid，此时设置对应的msgstr即可，最后运行compilemessages完成编译。

方法二：在视图层提前翻译变量 #

在视图中对变量进行翻译处理后再传入模板：

from django.utils.translation import gettext as _
from django.shortcuts import render

def your_view(request):
    # 提前翻译变量
    greeting = _('hello')
    return render(request, 'your_template.html', {'greeting': greeting})

这种方式下模板无需修改，blocktranslate直接使用已翻译好的变量值即可。

额外注意事项 #

• 避免手动添加msgid，尽量通过makemessages命令自动提取，确保翻译条目与代码/模板中的内容匹配。
• 确认LocaleMiddleware的顺序正确（需放在SessionMiddleware之后，CommonMiddleware之前），这是Django语言切换生效的前提。

内容的提问来源于stack exchange，提问作者UMR