python在Django中切换语言，中英文两种语言怎样切换-程序员充电站

你想要在 Django 项目中实现中英文两种语言的切换功能，需要从基础配置、翻译文件创建、模板 / 代码翻译，到前端切换按钮实现的完整流程。以下是适配 Django 4.x/5.x 版本的详细步骤，兼顾配置和实际使用场景：

一、核心实现思路

Django 的国际化（i18n）和本地化（l10n）功能是语言切换的基础，核心逻辑是：

配置项目支持多语言，指定中英两种语言；
创建翻译文件（.po/.mo），存储中英文对照文本；
在模板 / 代码中使用翻译标签 / 函数，动态加载对应语言文本；
实现语言切换逻辑（通过表单 / URL 参数），修改用户会话的语言配置。

二、具体实现步骤

步骤 1：基础配置（settings.py）

这是多语言功能的核心配置，需修改settings.py开启国际化并指定语言参数：

python

# settings.py import os BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) # 1. 开启国际化（必须） USE_I18N = True # 启用国际化 USE_L10N = True # 启用本地化（日期/数字格式等） # 2. 指定支持的语言（仅保留中英） LANGUAGES = [ ('zh-hans', '简体中文'), # 中文代码：zh-hans（简体），zh-hant（繁体） ('en', 'English'), # 英文代码：en ] # 3. 默认语言（项目启动时的默认语言） LANGUAGE_CODE = 'zh-hans' # 默认中文，可改为'en' # 4. 翻译文件存储路径（关键！需手动创建locale文件夹） LOCALE_PATHS = [ os.path.join(BASE_DIR, 'locale'), # 项目根目录下的locale文件夹 ] # 5. 配置中间件（关键！LocaleMiddleware必须在指定位置） MIDDLEWARE = [ 'django.middleware.security.SecurityMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', # 先有会话，才能存储语言 'django.middleware.locale.LocaleMiddleware', # 语言中间件（位置：Session之后，Common之前） 'django.middleware.common.CommonMiddleware', 'django.middleware.csrf.CsrfViewMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'django.contrib.messages.middleware.MessageMiddleware', 'django.middleware.clickjacking.XFrameOptionsMiddleware', ]

关键说明：

LOCALE_PATHS：指定翻译文件的存储目录，需手动在项目根目录创建locale文件夹；
LocaleMiddleware：作用是检测用户的语言偏好（会话 / COOKIE / 请求头），并加载对应翻译，位置必须在SessionMiddleware之后、CommonMiddleware之前；
LANGUAGES：仅列出需要支持的语言，前端切换时只能选择这里配置的语言。

步骤 2：创建翻译文件（.po/.mo）

翻译文件是存储 “原文 - 译文” 的核心，需通过 Django 命令生成并编辑：

步骤 2.1：创建 locale 目录

在项目根目录执行：

bash

mkdir locale # 对应settings.py中LOCALE_PATHS的路径

步骤 2.2：生成翻译模板文件（.po）

生成英文翻译文件：

bash

运行

# 进入项目根目录，执行以下命令（-l 指定语言代码） django-admin makemessages -l en

生成中文翻译文件（若默认语言不是中文，需手动生成）：
bash
```
django-admin makemessages -l zh-hans
```

执行后，会在locale目录下生成如下结构：

plaintext

locale/ ├── en/ │ └── LC_MESSAGES/ │ └── django.po # 英文翻译文件 └── zh-hans/ └── LC_MESSAGES/ └── django.po # 中文翻译文件

步骤 2.3：编辑翻译文件（.po）

打开locale/en/LC_MESSAGES/django.po（英文翻译文件），添加需要翻译的文本：

# django.po msgid "Welcome to our website" # 原文（模板/代码中使用的标识） msgstr "欢迎访问我们的网站" # 译文（英文环境下显示的文本） msgid "File Upload" msgstr "文件上传" msgid "Language" msgstr "语言"

打开locale/zh-hans/LC_MESSAGES/django.po（中文翻译文件），对应添加：

# django.po msgid "Welcome to our website" msgstr "欢迎访问我们的网站" msgid "File Upload" msgstr "文件上传" msgid "Language" msgstr "语言"

步骤 2.4：编译翻译文件（.mo）

编辑完.po文件后，需编译为二进制.mo文件（Django 实际加载的是这个文件）：

bash

django-admin compilemessages

编译后，locale/[语言]/LC_MESSAGES/下会生成django.mo文件，翻译生效。

步骤 3：在模板中使用翻译（前端文本）

在 HTML 模板中加载翻译标签，使用{% trans %}或{% blocktrans %}渲染多语言文本：

步骤 3.1：模板头部加载 i18n 标签

html

预览

<!-- templates/base.html --> {% load i18n %} <!-- 必须加载i18n标签 --> <!DOCTYPE html> <html lang="{{ LANGUAGE_CODE }}"> <!-- 动态设置页面语言 --> <head> <meta charset="UTF-8"> <title>{% trans "Website Title" %}</title> </head> <body> <!-- 简单文本翻译 --> <h1>{% trans "Welcome to our website" %}</h1> <!-- 带变量的翻译（用blocktrans） --> {% blocktrans with username=request.user.username %} Hello {{ username }}, welcome back! {% endblocktrans %} <!-- 语言切换表单（核心！） --> <form action="{% url 'set_language' %}" method="post"> {% csrf_token %} <input name="next" type="hidden" value="{{ request.path }}"> <!-- 切换后返回当前页面 --> <select name="language" onchange="this.form.submit()"> {% get_current_language as LANGUAGE_CODE %} {% get_available_languages as LANGUAGES %} {% get_language_info_list for LANGUAGES as languages %} {% for lang in languages %} <option value="{{ lang.code }}" {% if lang.code == LANGUAGE_CODE %}selected{% endif %}> {{ lang.name_local }} <!-- 显示语言的本地名称（如“简体中文”/“English”） --> </option> {% endfor %} </select> </form> </body> </html>

关键说明：

{% trans "文本" %}：用于无变量的简单文本翻译；
{% blocktrans %}：用于带变量的复杂文本翻译；
set_language：Django 内置的语言切换视图（无需自己写），接收language参数并修改会话语言。

步骤 4：配置语言切换路由

Django 内置了set_language视图，只需在urls.py中配置路由：

python

# 项目根urls.py from django.contrib import admin from django.urls import path, include from django.conf.urls.i18n import i18n_patterns # 可选：带语言前缀的URL urlpatterns = [ path('admin/', admin.site.urls), # 配置内置的语言切换视图（必须） path('i18n/', include('django.conf.urls.i18n')), ] # 可选：为URL添加语言前缀（如/zh-hans/upload/、/en/upload/） urlpatterns += i18n_patterns( # 你的业务路由，比如文件上传路由 path('upload/', include('app.urls')), )

关键说明：

path('i18n/', include('django.conf.urls.i18n'))：注册内置的set_language视图，对应模板中表单的action="{% url 'set_language' %}"；
i18n_patterns：可选功能，为 URL 添加语言前缀（如/en/upload/），方便 SEO 和用户识别当前语言。

步骤 5：在视图 / 模型中使用翻译（后端文本）

如果需要在视图、模型或表单中使用多语言文本，需使用 Django 提供的翻译函数：

5.1 视图中使用翻译

python

# app/views.py from django.shortcuts import render from django.utils.translation import gettext as _ # 普通翻译（即时生效） from django.utils.translation import gettext_lazy as _lazy # 惰性翻译（适合模型/表单） def home(request): # 普通文本翻译 message = _("Welcome to our website") # 带变量的翻译 username = request.user.username or "Guest" greeting = _("Hello %(username)s, welcome back!") % {'username': username} return render(request, 'home.html', { 'message': message, 'greeting': greeting })

5.2 模型 / 表单中使用翻译（惰性翻译）

python

# app/models.py from django.db import models from django.utils.translation import gettext_lazy as _lazy class UploadFile(models.Model): file = models.FileField(upload_to='uploads/', verbose_name=_lazy("Uploaded File")) # 字段名翻译 upload_time = models.DateTimeField(auto_now_add=True, verbose_name=_lazy("Upload Time")) class Meta: verbose_name = _lazy("Uploaded File") verbose_name_plural = _lazy("Uploaded Files")

步骤 6：测试语言切换功能

启动 Django 开发服务器：python manage.py runserver；
访问项目页面，看到语言切换下拉框；
选择 “English”，页面文本切换为英文；选择 “简体中文”，切换为中文；
切换后 URL 若配置了i18n_patterns，会自动添加语言前缀（如/en/）。

三、常见问题解决

翻译不生效：
- 检查LOCALE_PATHS路径是否正确，翻译文件是否编译为.mo；
- 检查LocaleMiddleware的位置是否正确；
- 重启 Django 服务器（翻译文件修改后需重启）。
中文乱码：
- 确保.po文件的编码是 UTF-8；
- 模板中设置<meta charset="UTF-8">。
语言切换后跳转到首页：
- 检查表单中next隐藏字段是否正确（value="{{ request.path }}"），确保返回当前页面。