Django执行makemigrations/runserver触发IndexError问题求助

问题重现 #

运行以下命令时触发相同错误：

python3.8 manage.py makemigrations
python3.8 manage.py runserver

错误堆栈核心信息：

File "/usr/lib/python3.8/gettext.py", line 436, in _parse
plural = v[1].split('plural=')[1]
IndexError: list index out of range

该错误由Django翻译逻辑触发，已排查INSTALLED_APPS配置，调整settings.py中LANGUAGES的gettext_lazy/gettext_noop用法后仍未解决。

可行解决步骤 #

• 检查翻译文件(.po)语法
  错误根源是gettext无法正确解析.po文件中的复数规则。遍历项目locale目录下的所有.po文件，确保Plural-Forms行格式正确，示例标准格式：

  "Plural-Forms: nplurals=2; plural=(n != 1);\n"
  

  重点排查是否存在缺少分号、引号不闭合、复数规则定义缺失等问题。

• 清理并重新编译翻译文件
  删除项目中所有.mo缓存文件，然后重新编译翻译：

  python3.8 manage.py compilemessages
  

• 校验LANGUAGES配置与locale目录匹配
  确保settings.py中LANGUAGES的语言代码与实际locale目录下的文件夹名称一致。例如设置('zh-hans', '简体中文')时，需存在zh_HANS或zh_CN的locale目录，且目录内有完整的翻译文件。

• 替换系统gettext模块（临时兼容方案）
  安装第三方gettext库替代系统模块：

  pip install gettext
  

  在settings.py开头添加导入：

  import gettext as gettext_module
  

  注：需测试该方案与当前Django版本的兼容性。

• 排查第三方应用的翻译问题
  逐个禁用INSTALLED_APPS中的第三方应用，运行命令测试，定位是否由某第三方APP的损坏翻译文件导致。找到后可尝试更新该应用或替换其翻译文件。

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