Tailwind CSS在Vite中不生效主因是postcss.config.js未被正确加载：需存在且格式合规（ESM用export default，CJS用module.exports），plugins中tailwindcss必须前置并显式声明，否则@tailwind指令不解析。
Tailwind CSS 在 Vite 项目里“不生效”，90% 是因为 postcss.config.js 没起作用——不是 Tailwind 装错了，而是 PostCSS 根本没调用它。
为什么 postcss.config.js 必须存在且格式正确
Vite 确实内置了 PostCSS，但它只在检测到 postcss.config.js（或 .cjs）文件时才真正加载插件链。没有这个文件，@tailwind base 这类指令就只是普通注释，不会被解析成 CSS 规则。
- ESM 项目（
package.json含"type": "module"）必须用export default，不能写module.exports，否则启动时直接报ReferenceError: module is not defined - 如果用
.cjs后缀，则必须用module.exports，且文件名得是postcss.config.cjs -
plugins对象里，tailwindcss必须排在autoprefixer前面；否则 autoprefixer 可能提前处理未生成的 utility 类，导致最终样式错乱
postcss.config.js 内容怎么写才不踩坑
最简但安全的写法（ESM 环境）：
export default {
plugins: {
tailwindcss: {},
autoprefixer: {},
}
}
常见错误包括：
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
立即学习“前端免费学习笔记（深入）”；
- 漏掉
tailwindcss: {}，只写了autoprefixer→ Tailwind 完全不运行 - 写成
tailwindcss: { config: './tailwind.config.js' }→ 多余，插件会自动读取默认路径 - 把整个对象包在
module.exports = ...里 → ESM 下直接崩溃 - 文件名拼错，比如
postcss.config.js写成postcss.config.json→ Vite 完全忽略
为什么 npx tailwindcss init -p 是推荐起点
这个命令一次性生成 tailwind.config.js 和 postcss.config.js，并确保两者基础结构兼容。手动创建容易遗漏关键点：
- 它生成的
postcss.config.js默认用 ESM 语法，适配当前主流 Vite 项目 - 它会在
tailwind.config.js中预填content字段，避免你因路径写错导致 build 后 class 全丢 - 它不加任何多余配置（比如
presets或postcss-preset-env），减少插件间冲突概率
验证 postcss.config.js 是否真生效
改完配置后别急着刷新页面，先做两件事：
- 删掉
node_modules/.vite和dist目录，重启vite—— Vite 会缓存 PostCSS 插件实例，旧缓存可能跳过新配置 - 在
src/index.css里临时加一行：body { background: red !important; }，如果这行生效但@tailwind utilities不生效，基本锁定是postcss.config.js里的tailwindcss插件没加载 - 检查终端启动日志：若看到
[vite] new dependencies optimized但没出现tailwindcss相关提示，说明插件未接入管道
最隐蔽的问题是：配置文件存在、语法合法、插件也列了，但 Vite 因缓存或路径权限问题根本没读它——这时候重装 postcss 包（pnpm add -D postcss）反而比调配置更管用。
