Django启用国际化支持（2）—实现界面内切换语言：activate()

news2025/4/9 4:40:19

文章目录

- ⭐注意⭐
- 1. 配置项目全局设置：启用国际化
- 2. 编写视图函数
- 3. 配置路由
- 4. 界面演示
- 5、扩展
- - 自动识别并切换到当前语言
  - 设置语言并保存到Session
  - 设置语言并保存到 Cookie

⭐注意⭐

以下操作依赖于 Django 项目的国际化支持。如果你不清楚如何启用国际化功能，请先参考：Django 启用国际化支持（1）—实现配置多国语言

1. 配置项目全局设置：启用国际化

在项目的全局配置文件 settings.py 中完成以下步骤：

（1）启用国际化功能

再次确认 USE_I18N = True，这是 Django 多语言支持的基础。

（2）定义支持的语言

使用 LANGUAGES 选项指定支持的语言列表，这样可以避免用户切换到不支持的语言，同时提升性能。

# settings.py
LANGUAGES = [
    ('en', 'English'),            # 英文
    ('zh-hans', 'Simplified Chinese'),  # 简体中文
]
USE_I18N = True  # 启用国际化功能

2. 编写视图函数

（1）首页视图 index

页面显示一个问候信息（根据语言切换）。
提供语言切换链接，点击后切换到对应语言。

（2）切换语言视图 set_language

根据用户选择的语言切换显示内容。
如果用户选择了不受支持的语言，返回错误信息。

# views.py
from django.conf import settings
from django.http import HttpResponse, HttpResponseBadRequest
from django.shortcuts import redirect
from django.utils.translation import gettext as _, activate

def index(request):
    message = _('hello world')  # 翻译字符串
    return HttpResponse(f"""
    <html>
        <body>
            <p>{message}</p>
            <a href="/set_language/?lang=en">English</a> |  <!-- 切换到英文 -->
            <a href="/set_language/?lang=zh-hans">中文</a> |  <!-- 切换到简体中文 -->
            <a href="/set_language/?lang=fr">français</a>  <!-- 一个未支持的语言 -->
        </body>
    </html>
    """)

def set_language(request):
    # 获取用户选择的语言参数，默认值为 'en'
    lang = request.GET.get('lang', 'en')
    # 获取项目中支持的语言列表
    supported_languages = dict(settings.LANGUAGES).keys()
    if lang in supported_languages:
        # 如果选择的语言是支持的
        activate(lang)  # 切换到该语言
        return redirect("/")  # 重定向回首页
    else:
        # 如果选择的语言不支持，返回错误信息
        error_message = f"Error: Language '{lang}' is not supported."
        return HttpResponseBadRequest(error_message)

3. 配置路由

在 urls.py 中配置 URL 路由：

# urls.py
from django.contrib import admin
from django.urls import path
from demo.views import index, set_language

urlpatterns = [
    path("admin/", admin.site.urls),
    path("", index),  # 首页
    path("set_language/", set_language),  # 语言切换处理
]

4. 界面演示

在这里插入图片描述

5、扩展

自动识别并切换到当前语言

可以根据用户浏览器的 Accept-Language 自动切换语言：

from django.utils.translation import get_language_from_request,activate

def index(request):
    lang = get_language_from_request(request)
    activate(lang)
    message = _('hello world')
    return HttpResponse(f"<p>{message}</p>")

设置语言并保存到Session

# views.py
from django.conf import settings
from django.http import HttpResponse, HttpResponseBadRequest
from django.shortcuts import redirect
from django.utils.translation import gettext as _, activate

....

def set_language(request):
    lang = request.GET.get('lang', 'en')
    supported_languages = dict(settings.LANGUAGES).keys()
    if lang in supported_languages:
        activate(lang)
        # 将语言存储到用户 Session 中（确保 Django 数据库已初始化）
        request.session['django_language'] = lang
        return redirect("/")
    else:
        error_message = f"Error: Language '{lang}' is not supported."
        return HttpResponseBadRequest(error_message)