Django静态资源版本哈希解决缓存更新问题

本文深入解析了 Django 中如何通过 ManifestStaticFilesStorage 实现静态资源的精准缓存更新：它基于文件内容生成唯一哈希后缀（如 main.a1b2c3d4.js），确保内容变更即路径变更，彻底规避浏览器和中间代理（CDN/Nginx）因缓存旧文件导致的线上问题；但这一机制高度依赖正确配置——必须在生产环境启用、严格使用 {% static %} 标签而非硬编码路径、确保 collectstatic 流程完整且 staticfiles.json 清单准确生成，并同步调整 CDN 和 Nginx 的缓存策略以识别哈希文件，否则再完美的哈希设计也会在部署链路中悄然失效。

staticfiles\_storage 用 ManifestStaticFilesStorage 而不是 StaticFilesStorage

默认的 StaticFilesStorage 不改文件名，浏览器靠 Cache-Control 或时间戳判断是否更新，容易缓存旧资源。换成 ManifestStaticFilesStorage 后，Django 构建时自动给每个静态文件加哈希后缀（比如 main.a1b2c3d4.js），HTML 中引用的也是带哈希的路径，文件内容一变，路径就变，浏览器自然加载新版本。

需要在 settings.py 显式配置：

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

注意：它依赖 collectstatic 生成 staticfiles.json 清单文件，所以部署前必须跑一遍 python manage.py collectstatic；本地开发时如果没开 DEBUG=False，这个存储类不会生效——它只在生产模式下才重命名文件。

模板里必须用 {% static %} 而不是硬编码路径

哈希文件名只在通过 Django 的静态文件系统解析时才生效。如果你在模板里写