Tailwind CSS 不支持动态类名是因为 JIT 编译器仅扫描源码中写死的字符串字面量，不执行 JS 插值，故 bg-[${color}] 等写法不会生成对应 CSS 规则；预定义完整类名或配置 safelist 是合规解法。
Tailwind CSS 无法识别 bg-[${color}] 或 text-${type}-600 这类动态拼接的类名，根本原因不是它“不支持动态”，而是它的 JIT 编译器压根不会执行 JavaScript——它只在构建时扫描源码里**已经写死的、完整的字符串字面量**。
Tailwind 的类名提取发生在 build time，不是 runtime
你写的 className={`text-${color}-600`} 在源码中就是一段模板字符串，编译器看到的是 text-${color}-600 这个未展开的表达式，而不是 text-blue-600。它不会运行 JS、不会推测变量值、也不会做字符串插值。
- 现象：DOM 中 class 属性显示正常（如
text-blue-600），但无样式生效 - 本质：该类名从未被写入最终 CSS 文件，浏览器查无此规则
- 影响范围：开发服务器（
npm run dev）和生产构建（npm run build）全都会失效 - 别试
!important或调换 class 顺序——CSS 规则根本不存在，覆盖无从谈起
预定义完整类名是最可靠、零配置的解法
把组合逻辑提前到数据层，让每个变量值本身就是可被扫描到的完整类名字符串。这样既符合 Tailwind 的设计约束，也利于 TypeScript 类型校验。
- ✅ 正确写法：
const theme = { primary: 'text-blue-600 bg-white', secondary: 'text-gray-700 bg-gray-100' }; - ✅ 使用方式：
className={theme.primary}—— 字符串静态、完整、无插值 - ⚠️ 注意：如果混入自定义类（如
my-custom-class），需额外加到safelist，否则会被 PurgeCSS 清掉 - ? 优势：无运行时开销、不膨胀 CSS 体积、类型安全、IDE 可跳转提示
必须用 safelist 的场景：值不可穷举且必须走 Tailwind 语法
当 color 是用户输入的 hex 值（如 #3b82f6）、API 返回的任意 type 字符串、或需要 bg-[url(...)] 这类语法时，safelist 是唯一合规入口。
立即学习“前端免费学习笔记（深入）”；
- 配置位置：
tailwind.config.js的safelist数组 - 支持正则：
{ pattern: /bg-\[#([0-9A-F]{6}|[0-9A-F]{3})\]/ }覆盖常见 hex 背景色 - ⚠️ 风险：正则太宽会引入大量无用 CSS；太窄会漏匹配；重启开发服务器才生效（缓存不自动更新）
- ❌ 不推荐用于业务逻辑类（如
from-${type}），优先走预定义方案
内联 style 是最直接、最可控的兜底手段
当动态值完全不可控（比如实时计算的 opacity、渐变 stop 位置、url() 路径），硬套 Tailwind 类名只会增加维护成本和构建不确定性。
- ✅ 推荐：
style={{ backgroundImage: `url(${props.imgUrl})`, opacity: isLoading ? 0.5 : 1 }} - ✅ 优势：浏览器原生支持、无需构建介入、调试直观、性能无损耗
- ? 提示：对高频变更的属性（如 transform、filter），可结合
useMemo或 CSS 变量进一步优化
真正容易被忽略的点是：很多人以为「只要 DOM 里 class 名对了，样式就该生效」，但 Tailwind 的规则生成和 DOM 渲染不在同一阶段。构建时没生成，运行时再怎么拼都白搭——这不是 bug，是设计使然。
