PostCSS必须在Sass编译之后运行,因其插件仅处理标准CSS语法,无法识别SCSS的$variable、@mixin等语法;若顺序颠倒,Webpack会报“Unknown word”或“Unexpected token '$'”错误。

PostCSS 必须在 Sass 编译之后运行
PostCSS 插件(如 autoprefixer、postcss-preset-env)只处理标准 CSS 语法,无法识别 SCSS 的 $variable、@mixin、@if 或嵌套写法。若把 postcss-loader 放在 sass-loader 前面,Webpack 构建会直接报错:Unknown word 或 Unexpected token "$"。
真实构建链路只能是:.scss → sass-loader → 标准 CSS 字符串 → PostCSS 插件处理。
- Webpack 用户需确认
module.rules中sass-loader在postcss-loader之前 - Vite 默认满足该顺序,但若手动配置了
css.postcss.plugins,要检查是否覆盖了vite-plugin-sass的前置编译 - 哪怕只用
postcss-preset-env启用nesting-rules,也得等 SCSS 先把.btn { &__icon { } }展开成合法 CSS,否则它看到的是非法结构
必须显式配置 postcss-scss 解析器(仅当直接处理 .scss 文件时)
如果你跳过 sass-loader、想让 PostCSS 直接读 .scss 文件(比如用 CLI 或某些精简流程),就必须启用 postcss-scss —— 它不是插件,而是解析器(parser),必须写在 postcss.config.js 的顶层,不能塞进 plugins 里。
错误写法:plugins: { 'postcss-scss': {} } → 无效,且仍报 Unknown word。
立即学习“前端免费学习笔记(深入)”;
正确写法:
module.exports = {
parser: 'postcss-scss',
plugins: [
require('autoprefixer'),
require('postcss-preset-env')({ stage: 3 })
]
}
-
postcss-scss@4.0.9对应postcss@8.4.38;PostCSS 9+ 当前无稳定适配版 - 该解析器只对
.scss文件生效;.css文件仍走默认解析器,混用时注意后缀别错 - 若项目同时用 Tailwind,它的
tailwindcss插件不关心语法,但依赖 AST 已被正确解析,所以parser必须最先加载
postcss-preset-env 不是“魔法”,它按 browserslist 决定是否转译
你写 color-mix() 或 :has(),它不会无条件降级。它查 .browserslistrc(或 package.json 中的 browserslist 字段),只对 Stage 2+、且目标浏览器不原生支持的特性做处理。
常见误区:
- 设
stage: 4却发现color-mix()没编译?因为该函数目前仍是 Stage 3,stage: 4反而把它过滤掉了 - 开启
'nesting-rules': true后,& .child会被转成.parent .child,但&:hover不会自动提升权重,原始语义受限 -
'custom-properties': { preserve: false }会把变量内联展开,若 JS 运行时动态改值,编译后就失效——这是设计使然,不是 bug
Autoprefixer 和 @mixin 不是替代关系
autoprefixer 是动态决策:根据 browserslist 查 Can I Use 数据,决定加不加 -webkit-、删不删 -moz-。而 SCSS @mixin 是编译期硬展开,无法响应浏览器演进。
例如 backdrop-filter,你写一个 @mixin backdrop($color),它永远输出固定前缀组合;但 autoprefixer 能在 Chrome 120+ 中自动省略 -webkit-,在 Safari 16.4+ 中保留它——这种适应性是 @mixin 给不了的。
结论很实在:用 autoprefixer 做主力,@mixin 只用于极少数 autoprefixer 不覆盖的场景(比如某些 Houdini fallback)。


















