django-compressor在debug=true时自动禁用压缩，无论compress_enabled是否为true；开发阶段需设debug=false或确保compress_offline=false才能生效，否则{% compress %}标签无效果。
为什么 COMPRESS_ENABLED = True 在开发环境没效果？
因为 django-compressor 默认行为是：当 DEBUG = True 时，自动禁用压缩（无论你是否显式设了 COMPRESS_ENABLED = True）。它不是“开关失灵”，而是设计如此——为避免开发时调试困难。
要强制在开发阶段启用压缩，必须同时满足两个条件：
-
DEBUG = False或者 - 显式设置
COMPRESS_ENABLED = True且COMPRESS_OFFLINE = False（默认值）
常见错误是只改 COMPRESS_ENABLED 却没关 DEBUG，结果模板里 {% compress css %} 渲染出来仍是原始多个 <link> 标签，毫无变化。
compress 模板标签里能放什么？
只能放合法的 HTML <link rel="stylesheet">、<script></script> 和内联 <style></style>/<script></script> —— 其他内容（比如 <div>、Django 变量渲染结果、未闭合标签）会导致 <code>TemplateSyntaxError 或静默失败。
典型安全写法：
- 外部 CSS：
<link rel="stylesheet" href="%7B%%20static%20'css/base.css'%20%%7D"> - 内联 CSS：
<style>.btn { margin: 0 }</style> - 外部 JS：
<script src="%7B%%20static%20'js/vendor.js'%20%%7D"></script> - 内联 JS：
<script>console.log('loaded');</script>
不能混用非静态资源路径，比如 href="/api/css" 或动态生成的 URL；也不支持 async/defer 属性出现在 <script></script> 标签里——这些属性会被保留，但压缩合并后语义可能错乱。
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
生产部署必须跑 python manage.py compress --force 吗？
取决于 COMPRESS_OFFLINE 设置。如果设为 True（推荐用于生产），就必须手动运行该命令，否则模板渲染时会报 OfflineGenerationError。
关键点：
-
COMPRESS_OFFLINE = True：所有压缩在部署前完成，生成带哈希名的文件（如css/abc123.css），不依赖运行时；需配合collectstatic一起执行 -
COMPRESS_OFFLINE = False（默认）：每次请求首次访问时动态压缩并缓存，适合开发，但生产环境有并发竞争风险，且首次加载慢 -
--force参数仅在离线模式下必要：它跳过哈希比对，强制重生成所有压缩文件，避免旧缓存残留
注意：compress 命令依赖 STATIC_ROOT 已存在且可写，且要求 compressor.finders.CompressorFinder 已加入 STATICFILES_FINDERS。
COMPRESS_CSS_FILTERS 和 COMPRESS_JS_FILTERS 怎么选？
默认过滤器（如 CssAbsoluteFilter + CSSMinFilter）够用，但容易踩坑：
-
CSSMinFilter依赖csscompressor包，不装会报ImportError；而cssmin是另一个包，名字相近但不兼容 -
JSMinFilter对 ES6+ 语法支持差，遇到const、箭头函数会直接崩溃；生产环境建议换compressor.filters.closure.ClosureCompilerFilter或compressor.filters.uglifyjs.UglifyJSAutomaticFilter（需额外装uglify-js） - 若用了 Sass/Less，得配预处理器过滤器（如
SassFilter），且确保系统已安装sassc或node-sass
真正影响上线的是过滤器链顺序：前面的过滤器输出必须能被后面的识别。比如 CssAbsoluteFilter 必须放在 CSSMinFilter 前面，否则相对路径会被压缩器误删。
