postcss.config.js未被读取的最常见原因是文件未置于项目根目录，或因package.json中"type":"module"导致cjs文件不兼容；验证方式为在配置文件中添加console.log，无输出即未加载。
postcss.config.js 文件没被读取到
最常见的情况是文件根本没进构建流程——PostCSS 不会自动扫描项目里所有叫 postcss.config.js 的文件，它只认项目根目录（即 package.json 同级）的配置。放错位置、拼错文件名（比如写成 postcss.config.cjs 但 package.json 里设了 "type": "module"），都会导致静默失效。
验证方式很简单：在 postcss.config.js 里加一行 console.log('postcss config loaded')，启动开发服务时看终端有没有输出。没输出？说明文件压根没被 require 进来。
- 确保文件名是
postcss.config.js或postcss.config.cjs（后者用于 ESM 项目） - 检查是否被 Git 忽略或 IDE 误删
- Vite 5+ 默认启用 PostCSS，但若你手动配了
css.postcss选项，反而可能覆盖默认行为
CSS 文件没走 PostCSS 流程
即使配置文件存在且正确，如果 CSS 没被 PostCSS 处理器接管，@tailwind、@apply、@import 等指令就只是注释，不会被解析。Vite 和 Webpack 默认只处理 .css、.pcss 等后缀，但如果你直接 @import 'xxx.css' 到一个已编译好的 CSS 文件里，那它就跳过了整个 PostCSS 链。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 检查构建工具文档确认支持的扩展名，优先用
.pcss或.postcss - Vue SFC 中
<style>块必须显式声明lang="postcss"才会被 postcss-loader 处理 - Webpack 项目里，
css-loader+postcss-loader顺序不能颠倒，且postcss-loader要放在css-loader之后、style-loader之前
插件没导出或顺序错误
PostCSS 插件不是装上就能用，必须在配置中显式导出。空对象、漏掉 plugins 字段、或者把 autoprefixer 放在 cssnano 后面，都可能导致前缀不加、类名被 purge、甚至报 Unknown at rule @tailwind 错误。
立即学习“前端免费学习笔记（深入）”；
-
postcss.config.js内容至少得是：module.exports = { plugins: [require('tailwindcss'), require('autoprefixer')] }; - 多个插件时，顺序很重要：预处理器（如
precss）→ Tailwind → Autoprefixer → 压缩（cssnano） - 如果用了
cssnano，务必禁用它的内置 autoprefixer：{ preset: ['default', { autoprefixer: false }] }，否则它会用自己的 browserslist 覆盖你的配置
browserslist 配置未生效或范围过窄
Autoprefixer 补不补前缀，完全取决于 browserslist 查询 Can I Use 的结果。写 "last 1 version" 几乎不加前缀；写 "IE 11" 却没配 flexbox: 'no-2009'，display: flex 就不会生成 -ms-flexbox。
- 优先在
package.json里写"browserslist"字段，比分散在插件参数里更可靠 - 运行
npx browserslist看实际匹配到哪些浏览器版本，别靠猜 - 对 IE 11 兼容 Flex，必须传
require('autoprefixer')({ flexbox: 'no-2009' })，这是硬性要求，不是可选项
@tailwind 或 bg- 类名，如果一个都没展开，问题一定出在 PostCSS 是否运行，而不是 tailwind.config.js 里 content 路径对不对。 
