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 v3 主题至 v4 OKLCH

把 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 回退视图预览广色域表现。

生成无障碍 OKLCH 50–950 色阶

本指南涉及的工具

相关格式

常见问题

使用 CSS oklch() 会影响浏览器兼容性吗?

2023 年以来的所有现代 Chrome、Safari、Firefox 和 Edge 均原生支持 oklch(),旧设备也可配合 Hex 兜底变量。

普通 sRGB 显示器上 Hex 与转换后的 OKLCH 看起来完全一致吗?

完全一致,只有主动提升彩度进入 P3 区间时才会在广色域屏幕展现更鲜艳的色彩。

更多色彩指南