在生产环境中使用 CSS Color Level 4 新语法时，必须通过 CSS.supports() 实时检测 rgb(0 0 0) 等写法的浏览器支持情况，因为 Safari 17.4 会静默忽略不合规语法；做兼容降级时，需按照 CSS 层叠顺序紧接旧语法，同时像 oklch()、color-mix() 这类特性也要分别检测，并显式声明色彩空间。
怎么检测浏览器是否支持 rgb(0 0 0) 这类新语法
不要依赖 User Agent 或浏览器版本号去推测，必须使用 CSS.supports('color', 'rgb(0 0 0)') 进行实时检测。Safari 17.4 遇到不合规写法时会直接静默忽略，既不会报错，也可能不会按预期 fallback，因此支持性检测是上线前的必要步骤。
很多项目会把检测结果只执行一次后缓存起来，但这种方式并不稳妥。因为用户可能在使用过程中切换深色模式，或者从桌面设备切换到 iPad 等不同环境。当window.matchMedia('(prefers-color-scheme: dark)')发生变化时，如果样式依赖oklch()或color-mix()，就应重新判断当前环境下的支持性。
- 在 CI/CD 流程中加入检查：
grep -r "rgb([^)]*,[^)]*)" src/，可快速定位旧式逗号语法残留 - JS 动态设置颜色时，不要直接写
el.style.color = 'rgb(255 0 0)'，应先检测支持再赋值 CSS.supports('color', 'oklch(0.5 0.2 260)')和CSS.supports('color', 'color-mix(in srgb, red, blue)')需要单独检测，因为它们的浏览器支持进度并不一致
如何安全降级 rgb(255 0 0 / 0.5) 这类写法
这并不是简单补一条 rgba(255, 0, 0, 0.5) 就能完全解决的问题。现代浏览器（Chrome 117+、Firefox 119+）通常会优先解析新语法，旧写法只作为 fallback；但 Safari 17.4 对部分新语法支持并不完整，甚至可能直接跳过整条规则。
更稳妥的推荐方式是：先写新语法，再在同一声明块中紧跟旧语法，并确保旧语法位于后面，让 CSS 层叠顺序真正发挥兼容作用：
button {
background-color: rgb(255 0 0 / 0.5);
background-color: rgba(255, 0, 0, 0.5);
}还要注意：#rrggbbaa 虽然写法简洁，但 Safari ≤ 17.3 对 #0f08 这类简写形式支持并不稳定，因此更建议使用完整的 #rrggbbaa 形式，并同时提供 rgba() 作为兼容降级方案。
- 构建工具如 esbuild、PostCSS 在压缩时可能处理空格异常，导致
rgb(255 0 0)→rgb(255 0 0)（少一空格），从而直接失效 - 在 Sass 中尽量避免
rgb($r, $g, $b)，改用插值写法rgb(#{$r} #{$g} #{$b} / #{$a}) - VS Code 对
hsl(0 100% 50%)可以正常显示颜色预览，但对hsl(0 100 50)不支持——百分号不能省略
hsl(from) 和 color-mix() 在生产中怎么避免静默失效
hsl(from var(--primary) h s calc(l - 10)) 这类相对颜色语法在生产环境里非常容易静默失效：少一个空格、漏写一个 calc()，或者 from 后没有空格，浏览器都可能直接丢弃整条声明，而且不会给出任何错误提示。
这里的关键在于：from 不是函数调用，而是一种解构语法；真正负责数值变化的是 calc()。另外，l 表示 0–100 的整数范围，如果写成 calc(l + 20%)，该声明会直接失效。
- 亮度超出范围时必须有兜底方案：
hsl(from var(--primary) h s max(15%, calc(l - 20))) color-mix()要求参数语法保持统一：不能混用rgb(255 0 0)和hsl(240, 100%, 50%)，否则整条声明会被忽略- 灰阶颜色建议使用
oklch(L 0 H)，不要依赖gray()—— 在 Safari 中依然不够可靠
oklch() 和 color-contrast() 的工程落地难点
oklch() 的 L 值具有感知均匀特性，但这里的 L 是 0–1 的小数范围，若写成 oklch(60% 0.2 260) 就会解析失败；而 color-contrast() 目前仅在 Chrome Canary 和部分 Firefox Nightly 中支持，正式生产环境中必须通过 polyfill 处理。
另一个最容易被忽略的问题，就是色彩空间必须显式声明。例如，color-mix(in srgb, red, blue) 里的 in srgb 绝不能省略，否则规则可能无法生效；再比如 color-contrast(var(--bg), white, black)，如果背景色本身是 oklch()，那么候选颜色最好也保持在同一色彩空间中，否则对比度计算结果就可能出现偏差。
- 在深色模式下批量提亮主题色时，不要逐个调整
hsl()的 l，直接统一修改oklch(L 0.2 260)的 L 会更稳定 color-contrast()并不保证返回列表中第一个达标颜色，而是返回对比度最高的候选色——如果你的业务依赖顺序语义（如“优先白色，不行再黑色”），就需要自行用 JS 实现 fallback 逻辑- 在 OLED 屏幕上，低饱和高亮度颜色容易显灰，使用
oklch()时应让 C（色度）配合min()做限幅，不能只调整 L
