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。
立即学习“前端免费学习笔记（深入）”；
- 安装：
npm install --save-dev gulp-postcss autoprefixer postcss - 配置
browserslist（推荐写在package.json里），例如："browserslist": ["> 1%", "last 2 versions", "not dead"] - PostCSS 插件顺序敏感：先
postcss-import，再autoprefixer，最后才是cleanCSS
如何让 Gulp 正确处理 @import 和相对路径？
原生 gulp.src('src/css/*.css') 不会递归解析 @import，直接压缩会导致子文件被忽略，样式丢失。必须用 postcss-import 或 gulp-cssimport 提前合并。
更隐蔽的问题是路径：如果 @import 'vars.css'; 在 src/css/base.css 里，而 vars.css 实际在 src/css/vars.css，默认解析会失败——因为 postcss-import 默认以当前文件所在目录为根，但 Gulp 的 base 选项可能干扰它。
- 用
postcss-import时，显式传入{ resolve: (id, from) => path.resolve(path.dirname(from), id) }更可靠 - 避免在
@import中用../跨目录跳转；统一用别名（如@import 'base/vars';）+postcss-import的path选项 - 若用
gulp-cssimport，注意它不支持 ES module 语法，且不会处理url()中的相对路径，容易导致图片引用 404
watch 时 CSS 变更没触发重编译？检查这些点
常见现象是改了 src/css/_mixins.css，但 gulp watch 没反应——不是 Gulp 问题，而是 glob 模式没覆盖到被 import 的文件。
gulp.watch('src/css/**/*.css', ...) 看似合理，但如果 _mixins.css 是下划线开头，默认被某些插件或系统忽略（尤其 macOS Finder 隐藏文件逻辑会干扰）；另外，PostCSS 的 import 解析是静态的，Gulp 不知道哪些文件被它依赖。
- watch 模式必须包含所有可能被 import 的文件：
['src/css/**/*.css', 'src/css/**/_*.css'] - 更稳妥做法：单独监听整个
src/css目录，不依赖文件名规则 - 如果用了
gulp-if或条件编译，确认isProduction变量在 watch 流程中始终正确传递，否则可能跳过 PostCSS 步骤
