tailwind-guidelines

用于编写、审查或重构 Tailwind CSS 代码时的规范参考。核心是工具类优先：优先在 className 中写工具类，仅在动画、伪元素等复杂选择器场景写自定义 CSS；组件中避免 @apply，改用 clsx 与 tw-merge 组合（如 cn() 辅助函数）处理条件类名与变体覆盖，避免字符串插值的动态类名。响应式采用移动优先，基准样式覆盖所有屏幕，sm/md/lg/xl/2xl 前缀从对应宽度起生效；组件级响应可用 @container 容器查询。暗色模式为每个颜色配对 dark: 变体，v4 用 @custom-variant dark，v3 在配置中设置 darkMode。颜色按角色选择色阶，支持透明度修饰符与 CSS 变量主题。排版给出字号、行高斜杠语法、字重与换行截断约定；间距优先 gap 而非 space-*。边框、ring 与 outline 分工使用，焦点样式不得直接移除，需保持对比度。状态变体支持 hover、focus-visible、disabled、group、peer 与 data 属性。文件还列出 v4 关键变更（CSS-first 配置 @theme、@utility、@custom-variant、@source、内置容器查询、text-sm/6 行高语法、渐变改名 bg-linear-to-r 等）、v4.1 新特性及迁移清单，并附常见反模式。官方未提供具体安装命令或收费信息。