Django Jinja如何通过变量路径引用静态目录中的文件？

方法1：在视图中预生成完整路径 #

在视图函数里先调用static()函数生成静态文件的完整路径，再将该路径传入模板上下文，之后直接用{% include %}加载：

# 视图代码
from django.templatetags.static import static
from django.shortcuts import render
from django.conf import settings
import os

def your_view(request):
    # 假设path是从上下文传入的变量
    path = request.GET.get('path')  # 或其他方式获取的path值
    # 若include需要本地文件路径而非URL，用STATIC_ROOT拼接
    full_path = os.path.join(settings.STATIC_ROOT, path)
    return render(request, 'your_template.html', {'full_static_path': full_path})

模板中直接使用：

{% include full_static_path %}

方法2：自定义模板标签（推荐） #

如果不想在视图中处理逻辑，可自定义一个模板标签，直接整合static和include的功能：

1. 在你的Django应用下创建templatetags目录，添加__init__.py和static_include.py两个文件。

2. 在static_include.py中编写标签逻辑：

from django import template
from django.template.loader import get_template
from django.conf import settings
import os

register = template.Library()

@register.simple_tag(takes_context=True)
def include_static(context, path):
    # 获取静态文件的本地绝对路径
    local_file_path = os.path.join(settings.STATIC_ROOT, path)
    # 加载并渲染模板片段
    try:
        template = get_template(local_file_path)
        return template.render(context)
    except Exception as e:
        # 可根据需求自定义错误处理
        return f"加载失败: {str(e)}"

3. 在模板中使用自定义标签：

{% load static_include %}
{% include_static path %}

注意事项 #

• 若静态目录未加入模板查找路径，get_template可能无法识别文件，需在settings.py的TEMPLATES配置中，将静态目录添加到DIRS列表：

TEMPLATES = [
    {
        # ... 其他配置项
        'DIRS': [
            BASE_DIR / 'templates',
            BASE_DIR / 'static',  # 将静态目录加入模板查找路径
        ],
    },
]

• 建议将模板片段放在templates目录下而非静态目录，静态目录更适合存放CSS、JS、图片等前端资源，模板片段属于模板范畴，放在templates更符合Django的设计规范。

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