本文介绍如何在不修改原始查询语句的前提下，基于当前激活语言自动将 SomeModel.objects.get(title=...) 重定向到对应语言字段（如 title_en 或 title_fr），并通过模型重构与查询封装实现可扩展、可复用的多语言查询逻辑。
本文介绍如何在不修改原始查询语句的前提下，基于当前激活语言自动将 `somemodel.objects.get(title=...)` 重定向到对应语言字段（如 `title_en` 或 `title_fr`），并通过模型重构与查询封装实现可扩展、可复用的多语言查询逻辑。
直接在现有模型中为每种语言定义独立字段（如 title_en、title_fr）虽直观，但存在严重维护缺陷：新增语言需频繁迁移数据库、ORM 查询无法统一抽象、filter()/values_list() 等链式操作难以自动适配语言上下文，且 Django 不允许通过 .annotate() 覆盖已声明的模型字段。
推荐方案：采用「单字段 + 语言标识」范式重构模型
from django.db import models
from django.utils.translation import get_language
class SomeModel(models.Model):
title = models.CharField(max_length=255)
language = models.CharField(
max_length=10,
choices=[
('en', 'English'),
('fr', 'Français'),
('de', 'Deutsch'),
# 可持续扩展
]
)
class Meta:
# 可选：联合唯一约束确保同一内容不重复存多语言版本
unique_together = ['title', 'language']
此设计将语言维度显式建模为数据属性，而非隐式字段命名，从根本上解耦结构与本地化逻辑。
关键：封装语言感知的查询接口
为保持原有调用习惯（如 SomeModel.objects.get(title=...)），需自定义 Manager：
class MultilingualManager(models.Manager):
def get(self, **kwargs):
lang = get_language()[:2].lower() # 提取 'en', 'fr' 等
# 将 title → title_en / title_fr 映射（若仍需保留旧字段名兼容性）
# 但更推荐统一使用 title 字段 + language 过滤
if 'title' in kwargs:
title_val = kwargs.pop('title')
return super().get(title=title_val, language=lang, **kwargs)
return super().get(**kwargs)
def filter(self, **kwargs):
lang = get_language()[:2].lower()
if 'title' in kwargs:
title_val = kwargs.pop('title')
return super().filter(title=title_val, language=lang, **kwargs)
return super().filter(**kwargs)
# 在模型中启用
class SomeModel(models.Model):
# ... 字段定义同上
objects = MultilingualManager()
此时以下调用均自动按当前语言生效：
# 当 LANGUAGE_CODE='en' 时，等价于 .filter(title='Hello', language='en')
SomeModel.objects.filter(title="Hello")
# 支持链式操作
SomeModel.objects.filter(title__icontains="test").values_list('id', flat=True)
# 支持 exclude、order_by 等所有 QuerySet 方法
SomeModel.objects.exclude(title__startswith="Temp")
注意事项与最佳实践：
- ✅ 避免字段冗余：不再需要 title_en/title_fr 等重复字段，降低迁移成本与存储开销；
- ✅ 支持动态语言切换：get_language() 在请求生命周期内实时生效，无需重启服务；
- ⚠️ 注意缓存一致性：若使用 cache_page 或 @cached_property，需将 language 加入缓存键；
- ⚠️ 数据库索引优化：为 (title, language) 添加复合索引提升查询性能：
class Meta: indexes = [ models.Index(fields=['title', 'language']), ] - ? 向后兼容过渡：若必须保留旧字段，可通过 @property 动态代理访问（不推荐长期使用）：
@property def title_en(self): return self.title if self.language == 'en' else None
该方案以正交设计替代字段爆炸，兼顾可维护性、可测试性与 Django ORM 原生能力，是 Django 多语言场景下的工业级实践标准。
