Tailwind CSS v3+ 的 CSS 压缩必须显式添加 --minify 参数，NODE_ENV=production 无效；需配合正确 content 路径扫描和 safelist 处理动态类名，三者缺一不可。
--minify 参数没加，NODE_ENV=production 不是压缩开关。
Tailwind CSS v3+ 的 CSS 压缩完全依赖显式传入 --minify，环境变量只影响周边插件（比如某些 PostCSS 插件），对 Tailwind 自身的文本压缩逻辑无作用。开发模式下即使加了 --minify 也会被忽略，它只在生产构建流程中生效。
CLI 构建命令漏了 --minify
这是最常见翻车点：本地调试时用 npx tailwindcss -i input.css -o output.css，看着能出文件，但体积纹丝不动。
- 错误写法：
npx tailwindcss -i ./src/input.css -o ./dist/output.css→ 输出未压缩、未裁剪 - 正确写法：
npx tailwindcss -i ./src/input.css -o ./dist/output.css --minify --content "./src/**/*.{js,ts,jsx,tsx,html}" - Windows 用户若依赖
NODE_ENV的其他插件，可用cross-env NODE_ENV=production，但它不替代--minify -
package.json中的"build"脚本如果写成"tailwindcss -i input.css -o output.css"，就等于跳过了压缩和内容扫描两道关键工序
content 配置错误导致 --minify 失效
--minify 只压缩文本（空格、换行、重复分号等），不删未用类。如果 content 没覆盖真实使用类名的文件，JIT 模式退化为全量输出，压缩再狠体积也下不去。
- 路径必须真实存在且格式严格匹配：比如项目里是
.tsx，就不能只写.ts；Next.js 项目要同时包含app/**/*.{js,ts,jsx,tsx}和pages/**/*.{js,ts,jsx,tsx} - 避免
./src/**这种带点前缀的写法——Vite/Next.js 解析不一致，统一用src/** - 路径含空格或特殊字符时，每个
--content值必须单独用双引号包裹：--content "src/components/**/*.{js,ts}" --content "public/*.html" - 动态类名（如
text-${color}）不会被扫描到，必须进safelist，否则会被当作“未使用”直接删掉——你看到 CSS 小了，但页面样式丢了
Node API 中 minify 默认是 false
如果你没走 CLI，而是用 @tailwindcss/node-api 的 compile() 方法，那压缩开关默认关闭，NODE_ENV=production 也无效。
- 错误写法：
await compile({ content: [] })→minify没传，默认false - 正确写法：
await compile({ content: [], minify: true }) - 注意：
minify: true仅压缩文本，删未用类仍靠content扫描结果
--minify 显式启用 + content 路径全覆盖 + 动态类有安全兜底三者同时到位。少一个，要么体积压不下去，要么样式就没了——而后者往往更难排查。 
