Django多语言项目中避免makemigrations生成不必要迁移文件的方法

核心原因 #

Django执行makemigrations时，会读取当前激活语言下的verbose_name、choices label等翻译后的值，若切换语言后，这些翻译值与迁移文件中存储的原始字符串不一致，就会被误判为模型变更，生成多余迁移。

具体解决办法 #

1. 执行命令时强制使用基础语言 #

在运行makemigrations前临时切换到代码中编写verbose_name、choices时用的原始语言（比如英文），让Django基于原始字符串生成迁移：

# Linux/macOS环境
LANGUAGE_CODE=en-us python manage.py makemigrations

# Windows PowerShell环境
$env:LANGUAGE_CODE="en-us"; python manage.py makemigrations

2. 固定项目默认语言为原始语言 #

在settings.py中将LANGUAGE_CODE设置为你编写模型时用的原始语言（比如en-us），前端用户的多语言切换通过django.middleware.locale.LocaleMiddleware处理，不影响后端迁移生成逻辑。这样日常开发和生成迁移时，默认都会读取原始字符串，避免翻译值干扰。

3. 模型定义中不直接用翻译函数包裹 #

不要在模型的verbose_name、choices里直接用_()（gettext）包裹内容，原始字符串直接写在代码里，翻译工作单独放在语言文件中：

• 错误示例：

  class Order(models.Model):
      status = models.IntegerField(choices=[(1, _("Paid")), (2, _("Unpaid"))])
  

• 正确示例：

  class Order(models.Model):
      status = models.IntegerField(choices=[(1, "Paid"), (2, "Unpaid")])
  

之后在django.po文件中添加对应翻译条目即可，这样迁移文件只会记录原始字符串，不受当前语言影响。

4. 清理已生成的多余迁移 #

如果已经生成了仅包含翻译内容变更的迁移文件，可直接删除这些文件，然后用基础语言重新执行makemigrations，再通过以下命令让数据库标记这些迁移已执行，避免影响现有数据：

python manage.py migrate --fake <你的应用名称>

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