Django模板include指令不继承static标签加载状态报错问题咨询

Django的模板系统中，include 语句默认传递的是变量上下文（即视图传入的变量、上下文处理器生成的变量等），但模板标签/过滤器的加载状态是每个模板文件独立的，不会随include传递，这是Django的固有设计，并非Bug。

每个模板都是独立的编译单元，{% load %} 语句是在单个模板的编译阶段执行的，仅作用于当前文件内的模板语法。你通过include引入的子模板会独立执行编译流程，因此父模板加载的static标签库对子模板完全不可见，才会抛出标签未找到的报错。

你可以根据项目需求选择以下两种方案：

方案1（最推荐）：每个用到static标签的子模板顶部声明加载 #

直接在所有用到{% static %}标签的子模板第一行加上{% load static %}即可。
Django原生支持重复加载同一个标签库，会自动做去重处理，不会产生额外性能损耗，也不会触发报错。这种方式的优势是每个模板都独立声明自身依赖的标签库，可维护性、可移植性更强，即使后续你把某个子模板迁移到其他项目/父模板中使用，也不会出现标签缺失的问题。

方案2：全局配置自动加载static标签库 #

如果你的项目大量模板都用到了static标签，不想每个文件都手动加加载语句，可以直接在Django配置中把static标签库设为全局自动加载，修改settings.py中的TEMPLATES配置项即可：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [BASE_DIR / 'templates'],
        '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',
            ],
            # 新增以下配置，将static标签库设为全局加载
            'builtins': [
                'django.templatetags.static',
            ],
        },
    },
]

修改完成后重启服务，所有模板无需手动load static就可以直接使用{% static %}标签。
注意：全局加载仅建议给static这种全项目高频使用的标签库开启，冷门的第三方标签库不建议全局配置，避免污染模板命名空间。

内容的提问来源于stack exchange，提问作者Zaid Al Shattle