使用Django REST时gettext异常：ModelSerializer选项翻译不一致

针对你遇到的CharField选项部分翻译正常、部分失效，且重新执行makemessages无效的问题，可从以下几个方向排查解决：

1. 检查翻译字符串是否被正确提取 #

• 打开对应语言的.po文件（比如locale/zh_Hans/LC_MESSAGES/django.po），确认失效的翻译项（比如_('Initiated')、_('Completed')）是否存在对应的msgid。
• 若缺失，执行django-admin makemessages -l zh_Hans --all强制重新扫描所有文件，确保模型文件被纳入扫描范围。如果模型在app的子目录里，要确认app/__init__.py配置正确，避免makemessages遗漏。

2. 核对翻译字符串的一致性 #

• 确保.po文件中的msgid与代码里的字符串完全一致，包括大小写、空格、标点。比如代码里是_('Pending')，.po里的msgid不能写成'pending'或' Pending'。
• 修正不一致的msgid后，执行django-admin compilemessages编译成.mo文件。

3. 确保序列化时正确获取带翻译的选项文本 #

• ModelSerializer默认不会自动序列化get_FOO_display()的结果，若直接序列化status字段，返回的是原始值而非翻译后的文本。需显式指定：

  class YourModelSerializer(serializers.ModelSerializer):
      status = serializers.CharField(source='get_status_display')
      
      class Meta:
          model = YourModel
          fields = ['status', ...]
  

• 或者使用SerializerMethodField手动处理：

  class YourModelSerializer(serializers.ModelSerializer):
      status_display = serializers.SerializerMethodField()
      
      def get_status_display(self, obj):
          return obj.get_status_display()
      
      class Meta:
          model = YourModel
          fields = ['status_display', ...]
  

4. 清除翻译缓存并重启服务 #

• Django会缓存翻译结果，即使更新了.po文件，缓存可能未失效。执行django-admin compilemessages重新编译后，重启Django服务。
• 若使用了第三方缓存后端，需手动清除缓存（比如执行python manage.py clearcache，或通过缓存管理工具操作）。

5. 验证语言设置是否生效 #

• 检查settings.py中是否启用了LocaleMiddleware，且顺序正确（需放在SessionMiddleware之后，CommonMiddleware之前）：

  MIDDLEWARE = [
      ...
      'django.contrib.sessions.middleware.SessionMiddleware',
      'django.middleware.locale.LocaleMiddleware',
      'django.middleware.common.CommonMiddleware',
      ...
  ]
  

• 测试时可手动激活目标语言，比如在视图中添加：

  from django.utils.translation import activate
  activate('zh_Hans')
  

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