类名撞车时，根本原因是Tailwind与Bootstrap等框架对text-center、container、flex等通用类名全局定义且权重相近，最终生效取决于构建后CSS顺序与选择器特异性；必须通过启用tw-前缀、设置important: true、禁用preflight及Bootstrap utilities模块来彻底解决。
类名撞车时，先看是不是和 Bootstrap 这类框架对上了
直接混用 Tailwind 和 Bootstrap，text-center、container、flex 这些短类名会互相覆盖，不是谁写在后面就赢——构建工具（Vite/webpack）会重排 CSS 顺序，浏览器只认最终生成的文件里谁的位置靠后、选择器更具体。常见现象包括：bg-blue-500 失效但 bg-primary 还在，rounded-lg 被 Bootstrap 的 .rounded 截断成 0，flex 被 .d-flex 覆盖导致响应式错乱。
靠改 import 顺序或加 !important 单独修饰某个类，都不稳定。真正有效的组合动作是：
- 在
tailwind.config.js顶层加prefix: 'tw-'，所有工具类变成tw-flex、tw-p-4，从字符串层面隔开 - 同时设
important: true（注意是布尔值，不是字符串），让带前缀的类自带!important，压制同权重规则 - 在
corePlugins中配preflight: false，否则@tailwind base会重置button等原生标签样式，导致按钮透明——这个跟类名无关，important: true完全无效 - Bootstrap 端要精简导入：只保留
reboot、type、grid，删掉utilities模块（它提供.text-center、.d-flex）
同一元素上多个 Tailwind 类互斥失效，本质是 CSS 规则顺序乱了
你写 class="rounded-md rounded-full"，本意是让后者覆盖前者，但实际可能还是圆角中等——这不是你写错了，而是 Tailwind 编译出的 CSS 文件里，.rounded-md 规则被意外排在了 .rounded-full 后面。Vue 项目中修改过 main.css、调整过 @tailwind 指令位置、或触发 HMR 异常时，特别容易出现这种顺序错乱。
不要依赖 HTML 中 class 的书写顺序来控制覆盖，而应在逻辑层确保互斥类只存在一个：
立即学习“前端免费学习笔记（深入）”；
- 用
computed或useMemo动态生成类名数组，rounded-md和rounded-full不共存 - 避免手拼字符串，比如
className={`${base} ${isRounded ? 'rounded-full' : 'rounded-md'}`，空格或undefined会污染结果 - 如果必须拼接，用
clsx过滤假值，再套twMerge解决覆盖逻辑：cn('p-4', isRounded && 'rounded-full', !isRounded && 'rounded-md')
第三方组件库按钮/输入框样式被 Tailwind “干掉”，大概率是 preflight 在作祟
Element Plus 按钮变透明、Naive UI 输入框边框消失，根本原因不是类名冲突，而是 Tailwind 的 @layer base（即 preflight）直接作用在标签上：button, [type='button'] { background-color: transparent; }。这条规则不靠类名触发，所以加 prefix、改 class 顺序、甚至用 <el-button></el-button> 包裹都无效。
检查 DevTools 的 Styles 面板，找带 data-tailwind="true" 的 button 规则，确认是不是 preflight 在起效。解决路径很明确：
- 首选关掉
preflight: false，然后用轻量 reset 补基础样式（如 normalize.css 或自定义@layer base） - 如果不能关 preflight（比如集成富文本编辑器），才考虑
important: '#app'局部锁定影响范围，避免波及弹窗、Tooltip 等浮动内容 -
important: true全局开启后，后续用!text-sm做微调会失效——因为所有工具类已带!important，!text-sm !important是非法语法
动态拼接类名时，空格、undefined 和覆盖逻辑全得手动兜住
直接写 className={`${base} ${isActive ? 'bg-blue-500' : 'bg-gray-200'} ${isLoading ? 'opacity-50' : ''}`}，表面能跑通，实则埋雷：
- 末尾多一个空格或
undefined会变成无效类名，比如"bg-blue-500 opacity-50 " -
p-4 p-6同时存在时，Tailwind 不自动取后者，谁生效取决于构建时 CSS 排列顺序 -
hover:text-blue-500和外部传入的hover:text-red-500冲突，谁赢不可控
生产环境该用 cn 函数封装：
import { clsx } from 'clsx';
import { twMerge } from 'tailwind-merge';
export function cn(inputs) {
return twMerge(clsx(inputs));
}
然后统一替换：className={cn(baseClasses, { 'bg-blue-500': isPrimary }, isLoading && 'opacity-50')}。注意：twMerge 不处理运行时拼的类名（如 text-${color}-500），这类必须由 Tailwind 编译器提前生成对应 CSS。
真正难的不是配置，是团队里有人漏改 HTML 中的 class、有人在 preflight 关闭后忘了补基础重置、有人在同一个元素上同时写 row 和 tw-grid——这些地方，配置兜不住，得靠代码审查和 eslint-plugin-tailwindcss 的 no-custom-classname 规则卡住。
