Django simple_tag自定义标签无法渲染返回字符串的问题咨询

1. 核心调用语法错误修正 #

simple_tag属于Django模板标签体系，不支持通过{{ }}变量语法调用，必须使用{% %}标签语法触发执行。
当前模板中写的{{ downloadable_menus }}，本质是从模板上下文中查找同名变量，由于视图从未向上下文传递该值，自然没有任何输出。
正确调用格式为{% downloadable_menus %}。

2. 标签模块可识别性校验 #

在修正调用语法前，需先确认Django能正常加载自定义标签库：

• 放置templatetags目录的应用（my_app.home）必须已添加至项目settings.py的INSTALLED_APPS列表，未注册的应用下的标签无法被系统识别
• templatetags目录需为标准Python包，即目录下必须存在空的__init__.py文件，否则Django无法将其识别为可导入模块
• 模板中的{% load menus %}语句需放置在模板文件头部，确保标签库在使用前完成加载

3. 函数参数定义修正 #

当前标签函数定义为：

def downloadable_menus(a):
    return 'Hello'

该函数带有一个无默认值的必传位置参数a，即便后续使用正确的标签语法调用，也会因未传入对应参数触发渲染报错。测试阶段如果不需要接收外部参数，直接删除这个无意义的参数即可。

4. 最小可运行代码示例 #

标签实现文件my_app/home/templatetags/menus.py #

from django import template
from django.utils.safestring import mark_safe

register = template.Library()


@register.simple_tag(name='downloadable_menus')
def downloadable_menus():
    """
    生成免费资源 mega menu 下的可下载菜单
    """
    test_content = 'Hello'
    # 后续拼接动态HTML时，必须通过mark_safe标记内容为安全格式，否则Django会自动转义HTML标签为纯文本实体
    return mark_safe(test_content)

模板调用代码 #

{% load menus %}

<div class="content">
    <ul class="menu-col">
       {% downloadable_menus %}
    </ul>
</div>

5. 动态菜单开发注意事项 #

后续从数据库拉取菜单数据拼接HTML时，不要直接返回拼接完成的字符串，必须通过mark_safe包裹返回内容，否则模板系统会自动转义所有HTML结构，导致菜单无法正常渲染。

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