当前位置：首页 > news >正文

Django国际化与本地化：Django 3 by Example多语言网站解决方案

news 2026/7/27 15:15:35

Django国际化与本地化：Django 3 by Example多语言网站解决方案

【免费下载链接】Django-3-by-ExampleDjango 3 by Example (3rd Edition) published by Packt项目地址: https://gitcode.com/gh_mirrors/dj/Django-3-by-Example

Django 3 by Example提供了完整的国际化与本地化解决方案，帮助开发者轻松构建支持多语言的网站。本文将详细介绍如何利用Django的内置功能实现网站的国际化配置、翻译管理和本地化适配，让你的网站能够无缝服务全球用户。

一、Django国际化核心配置

Django的国际化功能通过设置文件和中间件实现。在项目的settings.py中，你需要进行以下关键配置：

1.1 语言设置

首先定义支持的语言列表，使用gettext_lazy确保翻译字符串被正确标记：

from django.utils.translation import gettext_lazy as _ LANGUAGES = ( ('en', _('English')), ('es', _('Spanish')), )

1.2 国际化中间件

在MIDDLEWARE配置中添加LocaleMiddleware，确保请求能够正确处理语言偏好：

MIDDLEWARE = [ # ...其他中间件 'django.middleware.locale.LocaleMiddleware', ]

1.3 翻译文件路径

指定翻译文件存放目录，通常在项目根目录下创建locale文件夹：

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

二、模板翻译实现

Django提供了模板标签用于标记需要翻译的文本内容，主要有两种方式：

2.1 单句翻译

使用{% trans %}标签处理简单文本：

<title>{% block title %}{% trans "My shop" %}{% endblock %}</title> <a href="/" class="logo">{% trans "My shop" %}</a>

2.2 复杂块翻译

对于包含变量或多行文本的内容，使用{% blocktrans %}标签：

{% blocktrans with total=cart.get_total_price count items=total_items %} {{ items }} item, ${{ total }} {% plural %} {{ items }} items, ${{ total }} {% endblocktrans %}

三、翻译文件管理

Django提供了命令行工具来管理翻译文件的生成和编译：

3.1 提取翻译字符串

使用makemessages命令从代码和模板中提取所有需要翻译的字符串：

python manage.py makemessages -l es

这将在locale目录下生成.po文件，包含所有待翻译的文本。

3.2 编译翻译文件

翻译完成后，使用compilemessages命令将.po文件编译为Django可识别的.mo二进制文件：

python manage.py compilemessages

四、语言切换功能实现

为用户提供语言切换界面，通常在模板中添加语言选择器：

<p>{% trans "Language" %}:</p> <form action="{% url 'set_language' %}" method="post"> {% csrf_token %} <input name="next" type="hidden" value="{{ redirect_to }}"> <select name="language"> {% get_available_languages as LANGUAGES %} {% get_current_language as CURRENT_LANGUAGE %} {% for lang_code, lang_name in LANGUAGES %} <option value="{{ lang_code }}" {% if lang_code == CURRENT_LANGUAGE %}selected{% endif %}> {{ lang_name }} ({{ lang_code }}) </option> {% endfor %} </select> <input type="submit" value="Go"> </form>

五、多语言URL配置

为支持不同语言的URL路径，需要在urls.py中使用i18n_patterns：

from django.conf.urls.i18n import i18n_patterns urlpatterns = i18n_patterns( path('cart/', include('cart.urls', namespace='cart')), path('orders/', include('orders.urls', namespace='orders')), path('', include('shop.urls', namespace='shop')), )