Hex 转 OKLCH:将设计 Token 平滑迁移至 Tailwind CSS v4
分步讲解如何把旧版 Tailwind v3 Hex/HSL 配置升级为 CSS Color 4 @theme oklch() 色阶,获得一致亮度与 Display P3 支持。
约 6 分钟 阅读 · 更新于 2026-11-22
摘要对比
| 对比维度 | 旧版 Hex / HSL (Tailwind v3) | OKLCH @theme (Tailwind v4) |
|---|---|---|
| 语法写法 | tailwind.config.js Hex 字符串 | CSS @theme --color-* : oklch(...) |
| 感知亮度一致性 | 否——同明度黄远亮于蓝 | 是——L 轴直接追踪人眼亮度 |
| P3 广色域能力 | 局限在 8 位 sRGB | 原生支持 Display P3 与 Rec.2020 |
| 动态衍生明暗 | 依赖预处理器编译函数 | 原生 CSS oklch(from var(--c) ... ) |
为什么 Tailwind v4 默认把调色板全面换成 OKLCH
传统 sRGB Hex 代码隐藏了人眼真实的视觉明度。蓝色的 500 阶与黄色的 500 阶如果不单独校正,可访问对比度会剧烈波动。
OKLCH 把感知明度 L 放在首位、彩度 C 放第二位、色相角 H 放第三位,切换色相时按钮和徽章的视觉分量非常稳定。
- 50–950 对比阶梯高度一致:深色文字稳妥落于 50–400,白字稳妥落于 600–950。
- 原生 CSS 相对颜色语法免除 PostCSS 或 Sass 插件依赖。
把 tailwind.config.js 映射为 CSS @theme 块
直接将旧配置 theme.extend.colors 或 :root 变量粘贴到 Colr 的 Tailwind v3 转 v4 转换器中,即可按 D65 sRGB 矩阵精准算出标准 W3C oklch() 声明。
高明度区间(50–100)注意适度降低彩度以防溢出 sRGB 显示边界。
把 tailwind.config.js 映射为 CSS @theme 块
CSS@import "tailwindcss";
@theme {
--color-brand-50: oklch(97.2% 0.014 261.2);
--color-brand-500: oklch(54.6% 0.215 262.9);
--color-brand-700: oklch(42.4% 0.178 263.5);
--color-brand-950: oklch(23.1% 0.086 264.1);
}迁移后立即复核 WCAG 2.2 与 APCA 对比度
上线前请务必将整条 50–950 色阶放入对比度矩阵检验,重点关注 500–600 主色按钮配白字的临界值。
使用 Colr 的 OKLCH 色阶生成器可同屏标出 WCAG AA 与 APCA Lc 通过线。
- 核对 500 与 600 阶梯是否达到正文按钮 4.5:1 对比。
- 同步在 sRGB 回退视图预览广色域表现。
本指南涉及的工具
相关格式
常见问题
使用 CSS oklch() 会影响浏览器兼容性吗?
2023 年以来的所有现代 Chrome、Safari、Firefox 和 Edge 均原生支持 oklch(),旧设备也可配合 Hex 兜底变量。
普通 sRGB 显示器上 Hex 与转换后的 OKLCH 看起来完全一致吗?
完全一致,只有主动提升彩度进入 P3 区间时才会在广色域屏幕展现更鲜艳的色彩。
更多色彩指南
- OKLCH vs HSL vs sRGB:深入理解广色域 Display P3全面对比 HSL、sRGB Hex、Display P3 与 OKLCH 的视觉亮度准确性、渐变发灰死区、色域大小及渐进增强 CSS 写法。
- W3C Design Tokens (DTCG 2025.10):从 Figma 到 CSS 工程管线详解 W3C DTCG 2025.10 JSON 规范结构($type、$value colorSpace 与 components、别名),并实现与 CSS / Tailwind v4 的无损转换。
- WCAG 2.2 对比度 vs APCA (Lc):无障碍色彩完整指南对比 WCAG 2.2 相对亮度比(4.5:1)与现代 APCA 感知对比度(Lc 60/75/90),解决深色模式按钮失真与色觉障碍隔离。
- 同一色样的 RGB、HSL、HSV、HWB 与 OKLab 数值用 #336699 核对拾色器、CSS 声明和着色器。对照八种表示法,检查往返转换时的精度损失。