Django模板语法错误：自定义过滤器无效问题求助

嘿，我之前也踩过这个坑！Django模板确实不支持直接用变量当字典键，自定义过滤器是正确的解决思路，但「Invalid filter」报错基本都是配置或拼写的小问题，咱们一步步排查：

Django对自定义模板标签/过滤器的存放位置有严格要求：

• 必须在你的app目录下新建一个templatetags文件夹，而且这个文件夹里必须有__init__.py空文件（哪怕是空的也要有，不然Django识别不了这个模块）
• 过滤器文件的名字别随便叫filters.py，容易和Django内置的模块冲突，建议叫custom_filters.py这类个性化名字

正确的目录结构应该是这样：

your_app/
├── __init__.py
├── models.py
├── templatetags/
│   ├── __init__.py
│   └── custom_filters.py  # 你的过滤器文件
├── views.py
└── urls.py

然后看过滤器的注册代码，必须用@register.filter装饰器，示例代码如下：

# your_app/templatetags/custom_filters.py
from django import template

# 必须先创建这个Library实例，不能少！
register = template.Library()

@register.filter(name='get_dict_val')  # name参数是模板里要用的过滤器名，可选，默认用函数名
def get_dict_val(dictionary, key):
    # 用get方法避免键不存在时报错，返回空字符串或者你想要的默认值
    return dictionary.get(key, '')

在你的HTML模板最开头，必须先加载自定义过滤器模块，比如：

{% load custom_filters %}  <!-- 这里的名字是templatetags下的py文件名，比如custom_filters.py就写custom_filters -->

然后使用过滤器的语法是{{ 字典变量|过滤器名:键变量 }}，举个实际例子：

<!-- 假设你传给模板的context里有my_dict和current_key两个变量 -->
<p>当前键对应的值：{{ my_dict|get_dict_val:current_key }}</p>

如果你的app没添加到INSTALLED_APPS里，Django根本找不到你的自定义过滤器！打开settings.py确认：

INSTALLED_APPS = [
    # ... 其他内置app（比如django.contrib.admin这些）
    'your_app',  # 把你的app名字加在这里
]

• 重启服务器：修改templatetags里的代码后，必须重启Django开发服务器，不然会用旧的缓存代码，报错依然存在
• 拼写检查：过滤器名字、模块名字的大小写和拼写必须完全一致！Django是区分大小写的，比如你注册的是get_dict_val，模板里写成get_dict_value就会报错
• 不要和内置过滤器重名：比如别把过滤器名字叫get，会和Django内置的过滤器冲突

views.py #

from django.shortcuts import render

def test_dict(request):
    # 模拟你要传递的字典和动态键
    fruit_dict = {'apple': '苹果', 'banana': '香蕉', 'orange': '橙子'}
    selected_key = 'banana'  # 可以改成动态获取，比如request.GET.get('key', 'apple')
    return render(request, 'test_dict.html', {'fruit_dict': fruit_dict, 'selected_key': selected_key})

urls.py（app目录下的） #

from django.urls import path
from .views import test_dict

urlpatterns = [
    path('test-dict/', test_dict, name='test_dict'),
]

test_dict.html #

{% load custom_filters %}
<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>测试字典过滤器</title>
</head>
<body>
    <h2>当前选中的键：{{ selected_key }}</h2>
    <p>对应的值：{{ fruit_dict|get_dict_val:selected_key }}</p>
</body>
</html>

如果按照上面的步骤还是报错，把你的filter.py代码、模板代码和完整的错误信息贴出来，我再帮你定位问题！

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