Django i18n：模板渲染模型字段时如何全局翻译None值？

我之前处理过类似的需求，全局搞定Django模板里None值的翻译可比手动改每一处字段引用省心多了，给你两个实用方案：

方案一：全局模板过滤器（推荐，简单易维护） #

这个方案通过自定义一个模板过滤器，全局注册后批量处理所有None值，步骤如下：

1. 创建自定义模板过滤器 #

在你的Django应用目录下新建templatetags文件夹（如果没有的话），然后创建custom_filters.py文件，内容如下：

from django import template
from django.utils.translation import gettext as _

register = template.Library()

@register.filter(name='translate_none')
def translate_none(value):
    # 当值为None时返回翻译后的文本，否则返回原内容
    return _("Brak wartości") if value is None else value

这里直接写了波兰语的翻译文本，也可以用_("No value")，然后在翻译文件中配置波兰语对应的值，更符合Django的i18n流程。

2. 注册全局过滤器 #

打开settings.py，找到TEMPLATES配置，把刚才的过滤器添加到builtins中，这样所有模板无需手动load就能使用：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
            # 注册全局过滤器
            'builtins': ['你的应用名称.templatetags.custom_filters'],
        },
    },
]

3. 全局应用过滤器 #

在你的基础模板（比如base.html）中，用{% filter %}标签包裹整个内容块，这样所有子模板的内容都会自动经过过滤器处理：

{% filter translate_none %}
    {% block content %}{% endblock %}
{% endfilter %}

这样一来，所有模板中原本显示"None"的可空字段（比如你的end_date和notes）都会自动替换成翻译后的文本，完全不用手动修改每个字段的引用。

方案二：自定义模板后端（进阶，深度定制） #

如果你需要更深度的定制（比如区分不同类型字段的None处理），可以通过自定义模板后端来修改None值的默认渲染逻辑：

1. 创建自定义模板后端文件 #

在你的应用目录下新建custom_template_backend.py，内容如下：

from django.template.backends.django import DjangoTemplates
from django.template.base import VariableNode
from django.utils.translation import gettext as _

class CustomDjangoTemplates(DjangoTemplates):
    def get_template(self, template_name):
        template = super().get_template(template_name)
        # 遍历所有模板节点，修改变量节点的渲染逻辑
        for node in template.nodelist:
            if isinstance(node, VariableNode):
                original_render = node.render
                def new_render(context):
                    value = original_render(context)
                    # 把默认输出的"None"字符串替换成翻译文本
                    if value == "None":
                        return _("Brak wartości")
                    return value
                node.render = new_render
        return template

2. 替换默认模板后端 #

在settings.py的TEMPLATES配置中，把默认的后端替换成你自定义的：

TEMPLATES = [
    {
        'BACKEND': '你的应用名称.custom_template_backend.CustomDjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

这个方案不需要修改任何模板代码，直接全局替换所有"None"的输出，但相对复杂一些，适合需要完全全局定制的场景。

翻译配置注意事项 #

不管用哪种方案，都要确保你的翻译文件配置正确：

1. 运行django-admin makemessages -l pl生成波兰语的po文件
2. 在po文件中添加对应的翻译条目，比如：

   msgid "No value"
   msgstr "Brak wartości"
   

3. 运行django-admin compilemessages编译成mo文件，这样翻译就能正常生效了。

内容的提问来源于stack exchange，提问作者ssobczak