在Django REST Framework中实现多语言本地化的整体方案咨询

1. API接口方案：优先升级现有接口，而非单独开发翻译API #

单独开发翻译API会造成接口冗余，增加前端对接和后端维护成本，升级现有接口是更优选择：

• 语言识别：通过请求头Accept-Language（如zh-CN、en-US）或URL参数（如?lang=en）获取语言偏好，借助Django自带的django.middleware.locale.LocaleMiddleware自动处理语言切换，也可在视图集里手动解析语言参数。
• 序列化器改造：
  • 若使用django-modeltranslation，序列化器可直接包含翻译字段（如name_en、name_zh），通过动态逻辑过滤返回对应语言的字段；
  • 用SerializerMethodField根据当前语言返回对应值，示例代码：

    class ItemSerializer(serializers.ModelSerializer):
        name = serializers.SerializerMethodField()
        
        def get_name(self, obj):
            lang = self.context['request'].LANGUAGE_CODE
            return getattr(obj, f'name_{lang}', obj.name)
        
        class Meta:
            model = Item
            fields = ['id', 'name']
    

• 视图集适配：重写get_serializer_context，确保请求的语言信息传递到序列化器中，无需大幅修改原有业务逻辑。

2. CMS可更新数据的翻译：用关联表模式避免重复存储 #

不要为每种语言复制整行数据，采用主表+翻译表的关联存储方案，推荐使用django-parler（比django-modeltranslation更灵活，避免字段爆炸）：

• 模型定义：主表存储通用字段（如ID、创建时间），翻译表仅存储需要翻译的字段（如名称、描述），关联主表和语言代码：

  from parler.models import TranslatableModel, TranslatedFields
  
  class Product(TranslatableModel):
      # 通用字段
      price = models.DecimalField(max_digits=10, decimal_places=2)
      # 翻译字段
      translations = TranslatedFields(
          name=models.CharField(max_length=100),
          description=models.TextField()
      )
  

• CMS集成：django-parler自带Django Admin扩展，在Admin页面中可直接切换标签页录入不同语言的内容，无需额外开发CMS模块；
• 序列化处理：通过parler_rest扩展（适配DRF），自动根据当前语言返回对应翻译内容，无需手动处理字段映射。

3. 管理员维护的多表数据翻译：静态+动态结合方案 #

结合Django内置翻译机制和模型翻译库，区分静态文本和动态业务数据：

• 静态文本（如按钮文案、提示语）：继续用Django的gettext机制，通过Rosetta管理po/mo文件，在DRF视图中用_()函数调用翻译，示例：

  from django.utils.translation import gettext as _
  
  class SomeView(APIView):
      def get(self, request):
          return Response({"message": _("Hello World")})
  

• 动态多表数据（如分类、标签）：对这类需要管理员维护的业务模型，全部继承TranslatableModel（来自django-parler），在Admin中统一维护多语言内容；
• 关联查询处理：嵌套序列化器中直接调用翻译后的字段，比如分类下的商品列表，序列化器会自动返回当前语言的分类名称，无需额外关联查询翻译表。

额外实施要点 #

• 语言切换全局处理：配置settings.py中的LANGUAGES、LOCALE_PATHS，启用LocaleMiddleware，确保全站语言上下文一致；
• 缓存优化：对多语言响应结果做缓存，按语言维度区分缓存键，避免重复查询翻译数据；
• 降级机制：当某语言的翻译不存在时，返回默认语言（如英语）的内容，提升用户体验。

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