因为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 是否指向这些文件。 
