Django 翻译与 LANGUAGE_CODE

最新推荐文章于 2025-06-16 14:49:13 发布

weixin_30565327

最新推荐文章于 2025-06-16 14:49:13 发布

阅读量2.1k

点赞数

CC 4.0 BY-SA版权

文章标签： python

原文链接：http://www.cnblogs.com/jay54520/p/9372315.html

本文详细介绍了Django中的`LANGUAGE_CODE`设置，以及如何影响应用的翻译处理。`LANGUAGE_CODE`用于在无locale中间件时提供单一翻译，以及作为LocaleMiddleware找不到匹配语言时的后备选项。Django的翻译查找算法包括检查`LOCALE_PATHS`、`INSTALLED_APPS`中的APP目录和内置翻译。同时，文章提到了第三方APP翻译的替换问题，指出只有在特定目录结构下，自定义翻译才能生效，并提供了通过fork和子模块解决的方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

LANGUAGE_CODE[1]

LANGUAGE_CODE 是 language code 的字符串。格式与 Accept-Language HTTP header 相同，不区分大小写，比如：zh, es, zh-hans。所有的 language codes 见 http://www.i18nguy.com/unicode/language-identifiers.html 。

Django LANGUAGE_CODE 有两个作用：

如果没有设置 locale 中间件，那么这个用于给所有用户提供翻译。适用于只需要一种翻译的情况
如果设置了 locale 中间件，那么作为翻译的后备物品，用于没有匹配到语言的情况

LocaleMiddleware 决定用户语言的算法，顺序为 URL 语言前缀、session、cookie、Accept-Language HTTP 头部，最后是 LANGUAGE_CODE[2]。

注意：Django 的 LANGUAGE_CODE 是不区分大小的，但第三方 APP 就不一定了，比如 django-ckeditor 只有在 LANGUAGE_CODE 为 zh-hans 时翻译才会生效，所以它是区分大小写的。

寻找翻译的算法

在运行时，Django 会构建一个在内存中的、统一的文字翻译目录。依次在以下路径中加载信息文件（.mo）以及对同一字符串的翻译优先级如果对统一字符串存在多个翻译：

LOCALE_PATHS 有最高优先级，在 LOCALE_PATHS 中出现在前面的优先级更高。
然后查看 INSTALLED_APPS 中各个 APP 目录下的 locale/，也是在前面的 APP 优先级高
最后，django/conf/locale 作为后备

存放翻译文件的目录名为 locale name。在我看来就是将对应的 language code 的 - 替换为 _。比如 language code zh-Hans 的 locale name 为 zh_Hans。这点可以在 Django 自己的翻译中得到验证，比如 env/lib/python3.6/site-packages/django/conf/locale/zh_Hans。