首选ManifestStaticFilesStorage：它在collectstatic时自动生成内容哈希文件（如main.a1b2c3d4.css）和staticfiles.json映射表，模板中{% static 'main.css' %}自动解析为带哈希路径，确保CDN缓存精准控制且不脱节。
直接结论：用 ManifestStaticFilesStorage 或 PipelineManifestStorage，别手动写哈希逻辑。 Django 自带的 Manifest 机制才是生产环境静态资源版本控制的可靠路径，手动拼接哈希或靠 Webpack 输出名容易和模板引用脱节，导致缓存失效或 404。
为什么 ManifestStaticFilesStorage 是首选
它在 collectstatic 阶段自动为每个文件生成内容哈希（如 main.a1b2c3d4.css），同时生成 staticfiles.json 映射表，模板中调用 {% static 'main.css' %} 时会自动查表返回带哈希的路径。整个过程与 Django 的静态文件查找、URL 构建完全对齐。
- 不依赖前端构建工具输出名 —— 即使你用
webpack打包，也只需把输出目录加入STATICFILES_DIRS，让 Django 统一处理哈希 - 哈希基于文件内容，内容不变则哈希不变，避免无意义刷新 CDN 缓存
- 支持
post_process()链式处理（如 Gzip、S3 上传） - Django 4.2+ 强制使用
STORAGES配置，STATICFILES_STORAGE已弃用
STORAGES 配置必须写对的三个点
错一个就退化成普通文件拷贝，哈希全失效。
-
STORAGES["staticfiles"]["BACKEND"]必须设为"django.contrib.staticfiles.storage.ManifestStaticFilesStorage"（Django 自带）或"pipeline.storage.PipelineManifestStorage"（需装django-pipeline） -
STATIC_ROOT必须是非空绝对路径，且 Web 服务器（Nginx）要直接从该目录提供静态文件 —— Manifest 不是装饰器，它只在collectstatic时重命名并写映射 - 模板里一律用
{% static 'xxx.js' %}，不能硬编码/static/xxx.a1b2c3d4.js；否则 Manifest 表根本不会被查
常见踩坑：collectstatic 后没生成哈希文件
现象：STATIC_ROOT 下还是 main.css，不是 main.a1b2c3d4.css，浏览器缓存无法精准控制。
立即学习“Python免费学习笔记（深入）”；
- 检查是否漏了
STATIC_ROOT—— 没设它，ManifestStaticFilesStorage会静默退化为普通StaticFilesStorage - 确认
collectstatic命令加了--clear：旧文件残留会导致新哈希文件被跳过（因时间戳未更新） - 如果用了
django-pipeline，确保PIPELINE["JS_COMPRESSOR"]等压缩配置不抛异常，否则post_process()中断，哈希步骤不执行 - 检查文件权限：
STATIC_ROOT目录需可写，否则 Manifest 文件（staticfiles.json）写入失败，后续所有哈希解析都失效
CDN 场景下必须额外注意的点
Cloudflare 或 Nginx 反向代理后，浏览器看到的是 CDN 域名，但 Manifest 生成的 URL 仍基于 STATIC_URL。若 STATIC_URL 写死为 /static/，而 CDN 实际走的是 https://cdn.example.com/static/，模板里就会出错。
-
STATIC_URL应设为完整 URL，如"https://cdn.example.com/static/"（注意末尾斜杠） - 若 CDN 域名动态切换（如灰度环境），可用环境变量注入：
STATIC_URL = os.environ.get("STATIC_URL", "/static/") - Nginx 配置中不要用
alias指向STATIC_ROOT，改用root+location /static/，否则路径拼接易出错
真正麻烦的从来不是生成哈希，而是让哈希贯穿「构建 → 收集 → 模板渲染 → CDN 分发」整条链路。任何一环绕过 Manifest 机制（比如前端自己读取 Webpack 的 manifest.json），都会让 Django 的静态文件系统失去控制权。
