# Tailwind CSS

> 分类：`libs/ui/` · 档位：**评估** · 更新时间：2026-11-17

## 1. 基本信息

| 项 | 内容 |
|---|---|
| 当前版本 | 4.x |
| License | MIT |
| 维护方 | Tailwind Labs |
| 仓库 / 文档 | https://github.com/tailwindlabs/tailwindcss · https://tailwindcss.com |
| 最近 release | 见官方 releases |

## 2. 一句话定位

原子化（utility-first）CSS 框架：在标记里组合工具类，构建时扫描源码、只生成实际用到的样式。
它没有运行时，产物大小取决于用量，代价是必须引入构建步骤。

## 3. 体积

| 引入方式 | min | gzip |
|---|---|---|
| 生产产物（典型页面） | 依用量 | 约 6–12 KB（第三方口径，待实测） |
| 浏览器 CDN 版 | 较大 | 仅用于试验，不建议上线 |

## 4. 核心 API

```css
/* v4：CSS 优先配置 */
@import "tailwindcss";
@theme {
  --color-brand: #e7c15c;
}
```

```bash
npx @tailwindcss/cli -i input.css -o output.css --minify
```

```html
<div class="grid gap-4 md:grid-cols-2">
  <a class="rounded-xl border p-4 hover:border-neutral-600">…</a>
</div>
```

## 5. 适用 / 不适用

- **适用**：设计系统统一、多人协作、需要严格控制产物体积的项目。
- **不适用**：完全不想引入构建的静态页面（可退回原生 CSS 或 Pico.css）；重度依赖现成组件的后台（Bootstrap 更快）。

## 6. 硬缺口与已知坑

- 必须有构建步骤；浏览器 CDN 版会生成全量类，不适合生产。
- 动态拼接的类名（如 `text-${color}-500`）扫描不到，会静默缺失，需用完整类名或 safelist。
- HTML 里类名密度高，可读性依赖团队约定与组件封装。
- v3 → v4 配置方式变化较大（JS 配置改为 CSS `@theme`），迁移需评估。
- 没有自带组件与交互 JS，模态、下拉等仍需自己实现或配组件库。

## 7. 受限环境可用性

| 环境 | 结论 | 说明 |
|---|---|---|
| 无构建 | 不推荐 | CDN 版体积大，仅试验 |
| 构建流程 | 可用 | 标准用法 |
| SSR | 可用 | 只输出 CSS，与渲染无关 |
| 客户端重渲染 | 无影响 | 新类名需重新构建 |

## 8. 稳定性评分

| 维度 | 评分 | 依据 |
|---|---|---|
| 维护活跃度 | 5 | 迭代活跃 |
| 版本与破坏性变更 | 4 | v4 变更大但有迁移指南 |
| 采用度 | 5 | 生态与工具链成熟 |
| 体积与按需 | 5 | 产物随用量，通常很小 |
| 生态兼容 | 5 | 纯 CSS 产物 |
| License | 5 | MIT |

## 9. 替代品对比

| 库 | 优势 | 劣势 | 何时选它 |
|---|---|---|---|
| Bootstrap | 组件开箱即用、无构建也能跑 | 定制成本高、整包偏重 | 后台 / 原型 |
| UnoCSS | 更激进的按需引擎、可组合规则 | 生态小于 Tailwind | 追求极致产物 |
| Pico.css | 语义化、零构建、约 10 KB | 组件少 | 内容型页面 |
| 原生 CSS | 零依赖 | 设计系统与一致性要自己维护 | 简单站点 |
