用途：在 React、Vue、Svelte、Solid 等框架中动态组合 Tailwind 类字符串时，解决父组件传入的覆盖类与组件内部默认类的冲突。
主要能力：twMerge(...classLists) 接收可变字符串与空值，返回合并后的单一字符串，冲突类按 LAST-WINS 规则保留最后一个，忽略假值并展平嵌套数组。twJoin 仅拼接不做冲突解析，更快更小。extendTailwindMerge 返回自定义 twMerge，可扩展类组、主题刻度、前缀或冲突规则，须在模块作用域调用一次。createTailwindMerge 仅使用自定义配置。getDefaultConfig、mergeConfigs、fromTheme 与 validators 提供配置组合与校验辅助。
使用方式：安装时按 Tailwind 版本固定主版本，Tailwind v3.x 用 npm install tailwind-merge@2，v4.x 用 npm install tailwind-merge@3。shadcn 的 cn 辅助函数为 twMerge(clsx(inputs))。若 Tailwind 配置了前缀（如 tw-），必须通过 extendTailwindMerge({ prefix: "tw-" }) 告知，否则前缀类冲突无法识别。与 cva 搭配时，用 cn(buttonVariants({ variant, size }), className) 让消费者覆盖生效。
适用场景：类列表来自 props 或用户输入、存在变体覆盖、主题切换、外部 className 覆盖等可能冲突的情况。静态类、仅条件增删单个类、无客户端交互的服务端渲染可改用 clsx、twJoin 或构建时预计算。
限制：每次 twMerge 调用都有运行时成本；extendTailwindMerge 在渲染路径中调用会重建大型数据结构并破坏内部 LRU 缓存，默认缓存 500 条。版本与 Tailwind 主版本不匹配会静默产生错误合并。不覆盖 Tailwind 工具类编写、级联、插件编写与 shadcn/ui 组件配方。