django-modeltranslation未在Admin面板显示翻译字段，如何解决？

以下是逐一排查和解决的步骤：

1. 确认settings.py配置正确 #

确保modeltranslation已添加到INSTALLED_APPS，且配置好语言相关参数：

INSTALLED_APPS = [
    # 需放在django.contrib.admin之前
    'modeltranslation',
    'django.contrib.admin',
    # ... 其他应用
    'your_app_name',  # 替换为你的业务应用名称
]

# 配置支持的语言示例
LANGUAGES = [
    ('en', 'English'),
    ('zh', '中文'),
]

MODELTRANSLATION_DEFAULT_LANGUAGE = 'en'
MODELTRANSLATION_LANGUAGES = ('en', 'zh')

2. 验证translation.py的位置与导入逻辑 #

• translation.py必须和models.py处于同一应用目录下，路径不能错误。
• 建议明确导入模型而非使用通配符，避免导入异常：

from modeltranslation.translator import translator, TranslationOptions
from .models import Work, Category  # 替换原有的from .models import *

class WorkTranslationOptions(TranslationOptions):
    fields = ('title', 'text')
class CategoryTranslationOptions(TranslationOptions):
    fields = ('name',)

translator.register(Work, WorkTranslationOptions)
translator.register(Category, CategoryTranslationOptions)

3. 修改admin.py的模型注册方式 #

必须使用modeltranslation提供的TranslationAdmin类注册模型，否则Admin面板无法显示翻译字段：

from django.contrib import admin
from modeltranslation.admin import TranslationAdmin
from .models import Work, Category

class WorkAdmin(TranslationAdmin):
    list_display = ('title', 'date')  # 可自定义列表显示字段

class CategoryAdmin(TranslationAdmin):
    list_display = ('name',)

admin.site.register(Work, WorkAdmin)
admin.site.register(Category, CategoryAdmin)

4. 重新生成迁移文件（针对旧迁移异常场景） #

如果之前的迁移文件未正确生成翻译字段，执行以下操作：

• 删除应用目录下migrations文件夹中除__init__.py外的所有文件
• 进入数据库，删除django_migrations表中对应你的应用的迁移记录
• 重新执行命令：

python manage.py makemigrations
python manage.py migrate

5. 清除缓存并重启服务 #

• 清空Django缓存（若开启了缓存功能）
• 重启Django开发服务器，确保代码变更生效

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