如何引用Django生成的带哈希版本号的静态资源？

嘿，这个问题问到点子上了！这种带哈希后缀的静态文件正是Django用来优化缓存的绝佳方案——客户端/CDN可以放心缓存这些文件，一旦内容更新，哈希值自动变化，旧缓存自然失效。至于怎么引用新版本的资源，其实完全不用你手动去改文件名，Django已经帮你把这个流程自动化了，分几种常见场景给你说清楚：

1. 在HTML模板里引用（最常用场景） #

你只需要用Django内置的static模板标签，而不是硬写静态文件的路径：

• 首先在模板的开头加载static标签库：

  {% load static %}
  

• 然后在引用CSS/JS/图片的时候，用{% static '文件路径' %}代替直接写URL：

  <link rel="stylesheet" href="{% static 'css/theme.css' %}">
  <script src="{% static 'js/app.js' %}"></script>
  <img src="{% static 'images/logo.png' %}" alt="Logo">
  

当模板渲染时，Django会自动把这些路径替换成带哈希后缀的版本，比如css/theme.afeb1fc222a9.css，完全不用你手动跟踪哈希值的变化。

2. 处理静态文件内部的相对引用（比如CSS里的图片） #

如果你的CSS文件里有类似url('../images/bg.jpg')的相对路径引用，别担心——只要你在settings.py里配置了ManifestStaticFilesStorage（这是生成哈希文件的必要配置），Django会自动把这些内部引用也替换成带哈希的版本。

对应的settings.py配置项是：

STATICFILES_STORAGE = 'django.contrib.staticfiles.storage.ManifestStaticFilesStorage'

（能生成哈希文件说明你应该已经开了这个配置，不然不会出现带后缀的文件）

3. 在后端代码里引用静态资源 #

如果需要在视图、序列化器或其他后端逻辑中获取静态文件的带哈希URL，可以使用django.templatetags.static模块里的static函数：

from django.templatetags.static import static

def my_view(request):
    # 获取带哈希的CSS文件URL
    theme_css_url = static('css/theme.css')
    # 后续可以把这个URL传递给模板或者API响应
    return render(request, 'my_page.html', {'theme_css': theme_css_url})

额外注意事项 #

• DEBUG模式的小细节：如果DEBUG=True（本地开发环境），默认不会生成哈希文件，也不会自动替换路径。如果想在本地测试哈希功能，需要手动指定STATICFILES_STORAGE为上面提到的那个类，并且重新执行python manage.py collectstatic。
• 不要硬写带哈希的文件名：永远不要直接在代码里写css/theme.afeb1fc222a9.css这种带哈希的路径，下次更新资源后哈希值变了，你的代码就会失效。始终用static标签/函数来引用原始文件名，Django会帮你做映射。

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