如何在Python字符串中嵌入Django static标签以渲染图片？

核心思路 #

不要在Python代码里硬拼静态资源路径，要么用Django的static()函数生成正确URL后替换占位符，要么让模板引擎解析Python字符串里的{% static %}标签，避免引号冲突和路径错误。

方案一：占位符替换（推荐） #

通过static()函数生成合法的静态资源URL，再替换Python字符串里的占位符，最后在模板中安全渲染：

from django.templatetags.static import static

# 定义带占位符的HTML模板字符串
dynamic_html = '<div class="image-box"><img src="{img_url}" alt="产品图"></div>'

# 生成正确的static资源URL
product_img_url = static('products/phone.jpg')

# 替换占位符得到最终HTML
rendered_html = dynamic_html.format(img_url=product_img_url)

# 将rendered_html传入模板上下文，在模板中用{{ rendered_html|safe }}渲染

模板中渲染代码：

{{ rendered_html|safe }}

方案二：让模板引擎解析static标签 #

如果必须在Python字符串中直接写{% static %}标签，要注意引号嵌套规则，再用Django模板引擎二次渲染：

from django.template import Template, Context

# 外层用双引号，内层static标签里用单引号，避免引号冲突
dynamic_html_tpl = "<div class='image-box'><img src='{% static 'products/phone.jpg' %}' alt='产品图'></div>"

# 用模板引擎解析字符串中的static标签
template = Template(dynamic_html_tpl)
final_html = template.render(Context())

# 同样通过{{ final_html|safe }}在模板中渲染

常见错误规避 #

• 引号冲突：如果外层用单引号包裹HTML字符串，内层static标签里的路径要转义单引号，比如{% static \'products/phone.jpg\' %}
• 忘记safe过滤器：如果不加|safe，Django会把HTML转义成纯文本，导致图片标签和static标签无法生效
• 硬拼路径：不要手动写/static/xxx，用static()函数适配不同环境的STATIC_URL配置

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