Django繁中翻译配置完成后无生效 排查遗漏问题咨询
Django 繁体中文翻译不生效的排查指南
最常见遗漏:未编译翻译源文件
- Django 内置翻译引擎仅读取编译后的二进制
.mo文件,直接修改.po源码不会生效。 - 在项目根目录(与
manage.py同一层级)执行命令:django-admin compilemessages - 执行完成后确认
locale/zh-Hant/LC_MESSAGES/路径下生成了django.mo文件。
配置类遗漏排查
- 核对
LOCALE_PATHS路径:os.path.join(BASE_DIR, 'locale')指向的物理目录需与实际存放翻译包的根目录完全一致,且运行Django进程的用户拥有该目录的读取权限。 - 中间件顺序校验:
LocaleMiddleware必须位于SessionMiddleware之后、CommonMiddleware之前,你当前列出的顺序符合要求。 - 语言代码一致性校验:
LANGUAGE_CODE、LANGUAGES元组中的zh-Hant键值需完全匹配(无大小写、连字符差异),此处配置无问题。 - Django Heroku 配置覆盖排查:如果文件末尾调用了
django_heroku.settings(locals()),需检查Heroku环境变量中是否存在LANGUAGE_CODE等配置项覆盖了你本地的设置。
运行时干扰因素
- 浏览器语言优先级覆盖:
LocaleMiddleware会优先识别请求头中的Accept-Language偏好,若浏览器首选语言为英文且英文在LANGUAGES列表中,会优先返回英文页面而非默认的zh-Hant。可在URL后追加
?django_language=zh-Hant强制指定语言测试,或调整浏览器首选语言为繁体中文后刷新验证。 - 缓存与服务未重启:修改
.po文件、settings.py后必须重启Django服务(开发环境重启runserver,生产环境重启Gunicorn/WSGI进程),若开启了模板缓存、翻译缓存需同步清除。 - 翻译条目匹配校验:
.po文件中的msgid需与模板内{% trans %}后的字符串完全一致(包括大小写、标点、空格),若存在字符差异会无法匹配到翻译条目。
内容的提问来源于stack exchange,提问作者Hugo Yu
相关产品推荐
相关产品推荐

