Autoprefixer不会自动生效，必须通过PostCSS正确加载并处理CSS文件；常见问题根源在于PostCSS未运行、browserslist配置错误、CSS写法超出支持范围或与Tailwind/CSS-in-JS混用导致流程绕过。
Autoprefixer 不会自动生效，它必须被 PostCSS 正确加载、且 CSS 文件必须实际经过 PostCSS 处理流程——绝大多数“没加前缀”的问题，根源都在这一环断了。
PostCSS 根本没运行？先验证配置文件是否被读取
很多项目看似配了 postcss.config.js，但构建工具压根没加载它。Vite 5+ 默认启用 PostCSS，但如果你在 vite.config.js 里显式配置了 css.postcss，反而可能覆盖默认行为；Webpack 则完全依赖你手动引入 postcss-loader。
实操建议：
- 在
postcss.config.js里故意 require 一个不存在的模块，比如require('xxx-missing-plugin')，然后启动或构建——不报错就说明该文件根本没被读取 - 检查构建工具文档确认加载路径：Vite 要求
postcss.config.js在项目根目录；Webpack 要求postcss-loader在css-loader之后、且css-loader的importLoaders≥ 1，否则@import的 CSS 不进 PostCSS 流程 - Vue CLI 项目默认集成，但若用了
<style lang="postcss"></style>才走 PostCSS；普通<style></style>块需确认vue-style-loader+css-loader链路中是否包含postcss-loader
browserslist 配置错误，前缀就加得毫无意义
Autoprefixer 完全按 browserslist 输出前缀，不是靠经验或猜测。“last 2 versions” 会强制给 Safari 12 加 -webkit- 前缀，而它早已原生支持 gap；“> 1%” 可能拉进大量 IE11 用户，导致生成一堆 -ms- 前缀，但你的项目根本不支持 IE。
立即学习“前端免费学习笔记（深入）”；
实操建议：
- 优先把
browserslist写在package.json里，避免多处维护；不要用autoprefixer插件内的overrideBrowserslist参数 - 线上项目推荐显式声明，例如：
"iOS >= 13", "Safari >= 14.1", "Chrome >= 90"，比模糊语法更可控 - 运行
npx browserslist查看当前配置实际匹配哪些浏览器版本；再跑npx autoprefixer --info看哪些属性会被处理——别只凭记忆写
CSS 写法太新 or 太旧，Autoprefixer 直接跳过
Autoprefixer 只补前缀，不转译语法。它不会把 gap: 1rem 降级成 margin 模拟，也不会把 place-items: center 拆成 align-items + justify-items；反过来，IE11 的 display: -ms-grid 和现代 grid 差异极大，加了前缀也不等于能用。
常见错误现象：
- 写了
aspect-ratio: 1/1没任何前缀 → 正常，caniuse 显示该属性无主流前缀需求 -
backdrop-filter: blur(2px)在 Safari 15.4 下失效 → Autoprefixer 会加-webkit-backdrop-filter，但 Safari 15.4 才开始支持非-webkit-版本，旧版仍需前缀 -
grid-template-areas在 IE11 完全空白 → Autoprefixer 确实加了-ms-grid，但 IE 的 Grid 实现和标准不兼容，不能指望自动兜底
和 Tailwind / CSS-in-JS 混用时，前缀容易被绕过
Tailwind 默认已内置 Autoprefixer 逻辑，你在项目里再额外配一遍 autoprefixer 插件，可能导致重复处理或冲突；Emotion、Styled Components 这类 CSS-in-JS 库，若用 css 函数动态生成样式，PostCSS 通常不处理运行时生成的内容——那些样式根本没机会进 Autoprefixer 流程。
实操建议：
- Tailwind 项目删掉
postcss.config.js中的autoprefixer插件，改用tailwind.config.js的content+purge（v3）或content（v4）配合其内置前缀逻辑 - CSS-in-JS 场景下，确保使用的是支持构建时 CSS 提取的方案（如 Emotion 的
@emotion/react+@emotion/babel-plugin），而非纯运行时css函数调用 - 如果必须手写带前缀的规则（如某些 WebKit-only 功能），直接写
-webkit-xxx，Autoprefixer 不会删掉它，但也不会帮你补其他厂商前缀
最常被忽略的一点：Autoprefixer 的输出结果高度依赖 caniuse 数据快照。2026 年 4 月的 npx autoprefixer --info 结果，和 2024 年的完全不同——别沿用旧项目配置，每次升级 major 版本后，务必重新运行 npx browserslist 和 npx autoprefixer --info 验证。
