Django子应用中ugettext_lazy/pgettext_lazy翻译失效问题

我来帮你拆解这个问题，从基础配置排查到最终实现带上下文的延迟翻译，一步步搞定：

第一步：先确认子应用的国际化基础配置没踩坑 #

很多时候翻译不生效都是基础配置没到位，先检查这几点：

• 确保子应用sub_app已经添加到项目settings.py的INSTALLED_APPS里，Django的国际化扫描只会覆盖已注册的应用
• 检查子应用的locale目录是否正确生成，运行makemessages时有没有覆盖到子应用？比如可以手动指定子应用路径生成翻译文件：

  python manage.py makemessages -l zh_Hans -d django --locale-dir=sub_app/locale
  

  或者直接在项目根目录运行makemessages，让它自动扫描所有INSTALLED_APPS下的应用
• 确认子应用PO文件里的对应翻译条目已经填写了msgstr，并且运行了python manage.py compilemessages把PO编译成Django能识别的MO文件

第二步：排查ugettext_lazy的渲染问题（区分Django还是bootstrap3的锅） #

先做个简单测试，定位问题根源：

1. 在register.html里暂时去掉bootstrap_field，直接输出表单label：

   {{ form.email.label }}
   

   • 如果这个能正常显示翻译，说明问题出在django-bootstrap3的bootstrap_field标签处理上：
     有些旧版本的django-bootstrap3可能会对label文本做额外的字符串处理，导致Django的lazy翻译对象没被正确解析。你可以尝试升级django-bootstrap3到最新版，或者在模板里手动解析lazy对象（比如用{{ form.email.label|stringformat:"s" }}，不过升级是更稳妥的方案）
   • 如果直接输出也不显示翻译，说明是Django的lazy翻译加载有问题：
     检查你在主应用视图里导入子应用表单的位置——如果是在模块顶部（文件开头）导入的，比如from sub_app.forms import RegisterForm，会导致lazy翻译在模块加载时就初始化，而请求的语言设置是在请求处理阶段，这会导致翻译提前固化成默认语言。解决方法是把表单导入移到视图函数内部：

     def register(request):
         from sub_app.forms import RegisterForm
         form = RegisterForm()
         # ... 其他逻辑
     

第三步：切换到pgettext_lazy实现带上下文的翻译 #

当上面的问题解决后，就可以顺利切换到带上下文的延迟翻译了：

1. 在子应用的forms.py里导入pgettext_lazy：

   from django.utils.translation import pgettext_lazy
   

2. 定义表单字段时指定上下文：

   email = forms.EmailField(label=pgettext_lazy('user registration form', 'Email'))
   

   这里第一个参数是上下文标识（比如区分是注册表单还是登录表单的Email标签），第二个是要翻译的原始字符串
3. 重新生成并编译翻译文件：

   python manage.py makemessages -l zh_Hans
   python manage.py compilemessages
   

   此时子应用的PO文件里会生成带上下文的条目，像这样：

   msgctxt "user registration form"
   msgid "Email"
   msgstr "注册邮箱"
   

额外的排查小技巧 #

• 开启Django调试模式，在模板里输出{{ form.email.label|safe }}或者查看变量类型，确认它是lazy对象而不是普通字符串
• 检查settings.py的LOCALE_PATHS，确保包含了子应用的locale目录：

  import os
  from pathlib import Path
  
  BASE_DIR = Path(__file__).resolve().parent.parent
  
  LOCALE_PATHS = [
      os.path.join(BASE_DIR, 'main_site/locale'),
      os.path.join(BASE_DIR, 'sub_app/locale'),
  ]
  

• 确认当前请求的语言正确，在模板里加一句{% get_current_language as LANGUAGE_CODE %}{{ LANGUAGE_CODE }}，看是否是你设置的目标语言

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