零代码搞定多语言网站：Django国际化全攻略-优快云博客

零代码搞定多语言网站：Django国际化全攻略

【免费下载链接】django django/django: 是一个用于 Python 的高级 Web 框架，可以用于快速开发安全和可维护的 Web 应用程序，提供了多种内置功能和扩展库，支持多种数据库和模板引擎。项目地址: https://gitcode.com/GitHub_Trending/dj/django

你是否遇到过这些问题？辛辛苦苦开发的网站，国外用户打开全是乱码；想进军海外市场，却被多语言翻译搞得焦头烂额；运营人员想修改翻译文本，必须找程序员改代码？本文将带你用Django内置的国际化（Internationalization，简称i18n）与本地化（Localization，简称l10n）功能，零代码实现多语言网站，让你的Web应用轻松走向全球。

一、为什么需要国际化？

在全球化时代，一个成功的Web应用往往需要服务不同语言和文化背景的用户。Django的国际化功能可以帮助你：

自动检测用户语言偏好
提供多语言界面切换
支持日期、时间、数字的本地化显示
让非技术人员也能编辑翻译文本

Django官方文档详细介绍了国际化框架的设计理念，你可以通过docs/topics/i18n/index.txt深入了解其工作原理。

二、开启国际化功能

2.1 修改项目配置

首先，需要在settings.py中启用国际化功能。Django的默认配置文件django/conf/global_settings.py已经为我们提供了基础设置：

# 启用国际化
USE_I18N = True

# 支持的语言列表
LANGUAGES = [
    ("en", "English"),
    ("zh-hans", "Simplified Chinese"),
    ("es", "Spanish"),
    # 可以添加更多语言
]

# 默认语言
LANGUAGE_CODE = "en-us"

# 翻译文件存放路径
LOCALE_PATHS = [
    BASE_DIR / "locale",  # 项目级翻译文件
]

2.2 添加国际化中间件

在MIDDLEWARE配置中添加LocaleMiddleware，确保它位于SessionMiddleware之后和CommonMiddleware之前：

MIDDLEWARE = [
    # ...
    "django.contrib.sessions.middleware.SessionMiddleware",
    "django.middleware.locale.LocaleMiddleware",  # 添加此行
    "django.middleware.common.CommonMiddleware",
    # ...
]

这个中间件会根据用户的浏览器设置或会话数据自动选择合适的语言。

三、标记需要翻译的文本

3.1 在Python代码中标记

使用gettext函数标记需要翻译的文本：

from django.utils.translation import gettext as _

def welcome_message(user):
    return _("Welcome, %(username)s!") % {"username": user.username}

3.2 在模板中标记

首先加载i18n模板标签，然后使用trans或blocktrans标签：

{% load i18n %}

<h1>{% trans "Welcome to My Site" %}</h1>

{% blocktrans with username=user.username %}
    <p>Hello, {{ username }}! You have {{ count }} messages.</p>
{% endblocktrans %}

Django的模板国际化功能支持变量替换、复数形式等复杂场景，具体可以参考tests/template_tests/syntax_tests/i18n/test_blocktranslate.py中的测试用例。

四、生成和编辑翻译文件

4.1 生成翻译文件

使用Django的makemessages命令自动提取所有标记的文本：

# 为中文生成翻译文件
python manage.py makemessages -l zh-hans

# 为西班牙语生成翻译文件
python manage.py makemessages -l es

# 生成JavaScript翻译文件
python manage.py makemessages -d djangojs -l zh-hans

这个命令会在LOCALE_PATHS指定的目录下创建.po文件，例如locale/zh-hans/LC_MESSAGES/django.po。

4.2 编辑翻译文件

用文本编辑器打开.po文件，填写msgstr字段：

msgid "Welcome, %(username)s!"
msgstr "欢迎，%(username)s！"

msgid "Hello, {{ username }}! You have {{ count }} messages."
msgstr "你好，{{ username }}！你有 {{ count }} 条消息。"

4.3 编译翻译文件

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

python manage.py compilemessages

Django会自动使用这些编译后的文件来提供翻译。

五、实现多语言URL

5.1 配置语言前缀URL

使用i18n_patterns为URL添加语言前缀：

from django.urls import path
from django.conf.urls.i18n import i18n_patterns
from . import views

urlpatterns = i18n_patterns(
    path("", views.home, name="home"),
    path("about/", views.about, name="about"),
)

这样就会生成类似/en/about/、/zh-hans/about/的URL。

5.2 添加语言切换器

在模板中添加语言切换表单：

<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>
    <button type="submit">{% trans "Change language" %}</button>
</form>

Django的set_language视图会处理语言切换请求，并将用户重定向回原来的页面。

六、本地化日期、时间和数字

Django会根据当前语言自动格式化日期、时间和数字：

from django.utils import translation
from django.utils.formats import localize

with translation.override("zh-hans"):
    print(localize(datetime.now()))  # 输出类似 "2023年10月5日 14:30"
    print(localize(12345.67))       # 输出类似 "12,345.67"

你可以通过修改settings.py中的格式设置来自定义本地化格式，例如：

DATE_FORMAT = "Y年m月d日"
TIME_FORMAT = "H:i"
NUMBER_GROUPING = 3
THOUSAND_SEPARATOR = ","

七、测试国际化功能

Django提供了完善的国际化测试工具，你可以参考tests/i18n/目录下的测试用例来编写自己的测试。例如，使用Client测试不同语言的响应：

from django.test import TestCase
from django.test.client import Client

class I18nTest(TestCase):
    def test_chinese_translation(self):
        client = Client(HTTP_ACCEPT_LANGUAGE="zh-hans")
        response = client.get("/")
        self.assertContains(response, "欢迎")

八、常见问题解决

8.1 翻译不生效

如果翻译没有生效，可以检查以下几点：

USE_I18N是否设置为True
LocaleMiddleware是否添加到MIDDLEWARE中
翻译文件是否正确编译（.mo文件是否存在）
语言代码是否正确（如zh-hans而非zh）

8.2 动态内容翻译

对于数据库中的动态内容，可以使用django-modeltranslation等第三方库来实现多语言支持。

8.3 性能优化

大量的翻译文件可能会影响性能，可以通过缓存和django.middleware.cache.LocaleMiddleware来优化。

九、总结

Django的国际化功能为开发多语言Web应用提供了全方位的支持，从文本翻译到日期时间本地化，再到多语言URL配置，都可以通过简单的配置和少量代码实现。通过本文介绍的方法，你可以让你的Web应用轻松支持全球用户，无需复杂的国际化框架。

想要了解更多细节，可以查阅：

Django官方国际化文档：docs/topics/i18n/index.txt
国际化测试用例：tests/i18n/
模板国际化测试：tests/template_tests/syntax_tests/i18n/

现在，就用Django的国际化功能，让你的Web应用走向世界吧！

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考