gulp-clean-css 默认不生成 sourcemap,必须显式配置 cleanCSS({ sourceMap: true }) 并确保 gulp-sourcemaps.init() 在前、.write() 在后;同时 PostCSS(含 autoprefixer)须在 clean-css 前执行,且 @import 需用 postcss-import 正确解析路径,watch 需覆盖所有被 import 的文件(含 _*.css)。
为什么直接用 gulp-clean-css 压缩会丢失 sourcemap?
因为 gulp-clean-css 默认不生成 sourcemap,即使你配了 gulp-sourcemaps,它也不会自动读取或写入。必须显式启用:cleanCSS({ sourceMap: true }),且确保 gulp-sourcemaps.init() 在前、.write() 在后。
常见错误写法是把 cleanCSS() 放在 sourcemaps.init() 之前,或者漏掉 sourceMap: true 参数——结果压缩后报错找不到原始行号,调试 CSS 变得困难。
- 必须按顺序:先
gulp-sourcemaps.init()→ 再cleanCSS({ sourceMap: true })→ 最后gulp-sourcemaps.write() - 如果用了
@import或 PostCSS 插件(如postcss-import),sourcemap 链要完整,否则中间某环断掉就失效 -
cleanCSS的compatibility选项影响压缩强度,设为'ie11'会禁用部分现代语法压缩,但能避免低版本兼容问题
PostCSS + Autoprefixer 比单纯压缩更重要
很多项目只做压缩,却忽略 CSS 属性前缀缺失导致的样式失效。Autoprefixer 不是“锦上添花”,而是上线前必走一步——尤其当你用 flex、gap、aspect-ratio 这类新特性时。
Gulp 中集成需注意:PostCSS 必须在 clean-css 之前运行,否则 autoprefixer 处理的是已压缩的单行代码,无法正确解析嵌套或注释,甚至可能报错 Unclosed bracket。
立即学习“前端免费学习笔记(深入)”;