Django自定义模板过滤器报错：'custom_filters'未注册为标签库

报错信息：

'custom_filters' is not a registered tag library. Must be one of:
admin_list
admin_modify
admin_urls
cache
i18n
l10n
log
static
tz

按照以下步骤排查解决：

1. 确认templatetags目录结构合法性 #

• 确保templatetags是标准Python包：目录下必须存在空的__init__.py文件，文件名和路径不能有拼写错误。你的目录结构符合要求，但需检查__init__.py是否确实存在且无内容错误。
• 确认templatetags直接位于应用根目录（stream/下），没有嵌套在其他子目录中。

2. 重启Django开发服务器 #

Django仅在服务器启动时扫描并注册模板标签库，修改templatetags下的文件后必须重启服务器，否则新的标签库无法被识别。执行命令：

python manage.py runserver

3. 验证过滤器注册代码正确性 #

检查custom_filters.py代码：

from django import template

register = template.Library()

@register.filter
def get_item(dictionary, key):
    return dictionary.get(key)

• 确保register = template.Library()语句存在且拼写正确，这是注册标签/过滤器的核心入口。
• 过滤器装饰器@register.filter使用正确，没有语法错误。

4. 检查模板加载语法位置 #

模板中{% load custom_filters %}必须放在最顶部，在任何HTML内容或其他模板标签之前，你的index.html写法符合要求，但需确认标签库名称拼写完全一致（大小写敏感）。

5. 额外排查点 #

• 运行python manage.py check检查项目中是否存在语法错误，若custom_filters.py有语法问题，会导致标签库无法加载。
• 确认INSTALLED_APPS中'stream'应用名称拼写正确，无多余空格或符号。

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