Django特定应用locale目录未生成有效翻译文件问题

问题现象 #

• 项目根目录执行django-admin makemessages --all时，根目录locale下的.po文件能正常填充翻译内容，但about_page应用的locale目录生成的文件为空
• 进入about_page目录执行同一条命令，控制台提示已处理de、es、en、fr等语言，但生成的.po文件仍无内容

项目结构 #

├── about_page  # 该应用locale文件为空
│   ├── en  
│   ├── de
│   ├── es
│   ├── fr 
├── accessories
├── callibrators
├── careers
├── contact_page
├── db.sqlite3
├── dimensional_measurement
├── leak_testing
├── locale  # 该目录下的.po文件正常填充内容
│   ├── en  
│   ├── de
│   ├── fr
│   ├── es
├── manage.py
├── mysite
├── newsnevents_page
├── polls
├── products_page
└── services

settings.py相关配置片段 #

from django.utils.translation import gettext_lazy as _

LANGUAGES = [
    ('en', _('English')), 
    ('de', _('German')),
    ('fr', _('French')),
    ('es', _('Spanish')),
]

LOCALE_PATHS = [
    os.path.join(BASE_DIR, 'locale'),    
    os.path.join(BASE_DIR, 'about_page', 'locale'),
]

INSTALLED_APPS = [
    'polls.apps.PollsConfig',
    'about_page.apps.AboutPageConfig',
    'contact_page.apps.ContactConfig',
    'products_page.apps.ProductsPageConfig', 
    'careers.apps.CareersConfig',
    'newsnevents_page.apps.NewsneventsPageConfig',
    'dimensional_measurement.apps.DimensionalMeasurementConfig',
    'leak_testing.apps.LeakTestingConfig',
    'callibrators.apps.CallibratorsConfig',
    'services.apps.ServicesConfig',
    'accessories.apps.AccessoriesConfig',
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'django_recaptcha',
    'rosetta', #NEW
]

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.locale.LocaleMiddleware', 
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

ROOT_URLCONF = 'mysite.urls'

解决方案 #

1. 验证应用内的翻译标记正确性 #

确保about_page应用的模板、视图、模型中使用了正确的翻译语法：

• 模板文件：使用{% trans "需要翻译的文本" %}或{% blocktrans %}多文本块{% endblocktrans %}
• Python代码（视图/模型）：使用from django.utils.translation import gettext as _或gettext_lazy包裹待翻译字符串
• 注意：直接用变量传递给翻译函数不会被识别，必须是硬编码字符串（或用blocktrans处理变量）

2. 使用正确的命令生成翻译文件 #

不要直接用django-admin，改用项目根目录的manage.py执行，确保加载完整的项目配置：

python manage.py makemessages --all

如果需要单独为about_page应用生成文件，需指定目录和翻译域：

python manage.py makemessages --all --locale=en --locale=de --locale=fr --locale=es --domain=django --directory=about_page

3. 调整LOCALE_PATHS配置（避免全局与应用级翻译冲突） #

Django会自动搜索已安装应用下的locale目录，无需将应用级路径添加到全局LOCALE_PATHS，移除后可避免加载优先级冲突：

LOCALE_PATHS = [
    os.path.join(BASE_DIR, 'locale'),    
    # 移除该行：os.path.join(BASE_DIR, 'about_page', 'locale'),
]

4. 修复应用locale目录结构 #

确保about_page的locale目录符合标准结构，缺少LC_MESSAGES子目录会导致生成的文件为空：

about_page/
├── locale/
│   ├── en/
│   │   └── LC_MESSAGES/
│   ├── de/
│   │   └── LC_MESSAGES/
│   ├── es/
│   │   └── LC_MESSAGES/
│   └── fr/
│       └── LC_MESSAGES/

5. 清除旧文件后重新生成 #

删除about_page/locale下所有空的.po文件，再执行生成命令，避免旧文件缓存干扰。

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