因为collectstatic仅收集静态文件而不触发压缩逻辑，django-compressor默认在模板渲染时或执行compress命令时才编译；预编译需同时启用compress_enabled=true和compress_offline=true，并正确配置compress_root、compress_storage与staticfiles_storage对齐。

为什么 collectstatic 不触发 Django-Compressor 编译

默认情况下，collectstatic 只复制静态文件，不执行压缩或合并逻辑——Django-Compressor 的编译（如 JS/CSS 合并、minify）发生在模板渲染时，或显式调用 compress 命令。生产环境要求“预编译”，即在部署前生成最终文件，避免运行时开销和模板渲染失败风险。

• 没装 compressor.finders.CompressorFinder 到 STATICFILES_FINDERS，会导致 collectstatic 完全忽略 {% compress %} 块里的资源
• COMPRESS_ENABLED = True 和 COMPRESS_OFFLINE = True 必须同时启用；仅设 COMPRESS_ENABLED 仍走运行时流程
• 若用了自定义 COMPRESS_STORAGE，需确保该 storage 支持写入（比如本地 FileSystemStorage），否则预编译会静默失败

如何让 compress 命令输出到 STATIC_ROOT 而非临时目录

Django-Compressor 默认把预编译产物放在内存或临时目录，但生产部署需要它们最终落在 STATIC_ROOT 下，与 collectstatic 输出一致。关键在于配置 COMPRESS_ROOT 和 COMPRESS_OUTPUT_DIR，并确保 storage 与 STATICFILES_STORAGE 对齐。

Django Unfold

提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。

下载

• COMPRESS_ROOT 应设为 STATIC_ROOT 的值（不是 STATICFILES_DIRS）；否则生成的文件路径错位，Nginx/Apache 找不到
• COMPRESS_OUTPUT_DIR 默认是 CACHE，建议改为 compressed 或 gen，避免和原始静态文件混在一起
• 必须设置 COMPRESS_STORAGE = STATICFILES_STORAGE，否则 compress 命令会用默认 storage 写入，导致产物不在 STATIC_ROOT 中

Sublime 中运行 compress 命令的构建系统怎么配

Sublime 本身不执行 Django 管理命令，但可通过自定义构建系统调用 python manage.py compress。重点是路径、解释器、工作目录三者必须对齐，否则报 No module named 'compressor' 或找不到 settings。

• cmd 必须用绝对路径指向虚拟环境的 python，例如 ["/home/user/project/venv/bin/python", "manage.py", "compress"]
• working_dir 设为 "${project_path}"，确保 manage.py 能加载项目配置
• 不要依赖 shell 激活虚拟环境——Sublime 构建系统不继承 shell 的 source venv/bin/activate 状态
• 可在构建后加 "shell_cmd": "echo 'Compression done. Now run collectstatic.'" 提示下一步，避免漏掉 collectstatic

预编译后 CSS/JS 路径 404 的常见原因

即使 compress 成功执行，浏览器仍 404，通常不是压缩失败，而是 URL 映射断链。Django-Compressor 生成的文件名含哈希（如 css/abc123.css），但模板里引用的路径未更新，或 Web 服务器未正确映射 STATIC_URL 到 STATIC_ROOT。

• COMPRESS_CSS_FILTERS 和 COMPRESS_JS_FILTERS 若包含 compressor.filters.css_default.CssAbsoluteFilter，它会重写 CSS 中的 url() 路径——但前提是原始 CSS 文件里的路径是相对的，且 COMPRESS_ROOT 设置正确
• Nginx 配置中 location /static/ 必须指向 STATIC_ROOT 物理路径，而不是源码里的 static/ 目录
• 检查浏览器开发者工具 Network 标签页，看请求的是 /static/compressed/xxx.css 还是 /static/css/xxx.css——前者说明压缩生效，后者说明模板没走 {% compress %} 或 COMPRESS_OFFLINE = False

预编译本质是把运行时负担提前到部署阶段，但每一步都依赖配置项之间严格对齐：STATIC_ROOT、COMPRESS_ROOT、COMPRESS_STORAGE、Web 服务器的静态路径映射，缺一不可。最容易被跳过的其实是验证环节——别只看 compress 命令是否返回 success，要打开生成的 STATIC_ROOT/compressed/ 目录，确认文件存在且非空，再比对模板渲染出的 HTML 里 src 和 href 是否指向这些文件。