@supports (color: color(display-p3 0 0 0)) 是唯一可靠检测方式，因它直接验证浏览器CSS引擎对display-p3函数的解析能力，而非仅依赖设备硬件支持或系统上报的color-gamut值。
@supports (color: color(display-p3 0 0 0)) 是唯一可靠检测方式
用 @media (color-gamut: p3) 检测会漏掉关键环节：它只说明设备硬件支持 P3，不保证浏览器能解析 color(display-p3) 语法。Firefox 至今不支持该函数，Chrome 117+ 和 Safari 16.4+ 才开始稳定解析——但前提是 CSS 引擎本身启用，而非屏幕有没有 P3 能力。
真正起作用的是直接测试引擎对函数的识别能力：@supports (color: color(display-p3 0 0 0))。这个声明在不支持的浏览器中整条规则被跳过，不会触发任何降级或报错；在支持的环境中才进入样式应用流程。
常见错误包括：
- 把
@supports套在@media (color-gamut: p3)里面——叠加后反而增加失效概率，且无实际意义 - 写成
@supports color(display-p3)（缺括号和值）或@supports (color: display-p3)（缺color()函数包裹）——语法错误导致检测永远为 false - 在本地
file://协议下测试——Safari 和 Chrome 均要求 HTTPS 才启用广色域渲染管线，@supports可能返回 true，但颜色仍静默降级
为什么不能用 window.matchMedia('(color-gamut: p3)')
window.matchMedia('(color-gamut: p3)') 返回 true 只代表系统上报了 P3 能力，不代表当前页面渲染上下文已启用 P3 色彩管理。比如 iOS 上启用了“降低动画效果”或“色彩滤镜”，即使设备是 iPhone 15 Pro，该查询也常返回 true，但 color(display-p3) 依然被忽略。
立即学习“前端免费学习笔记（深入）”；
更关键的是：这个 JS API 不同步于 CSS 渲染时机。你在 JS 里判断为 true，紧接着插入的 style 标签若没用 @supports 包裹，样式照样无效。
所以它适合做日志上报或灰度开关，但不能替代 CSS 层面的 @supports 检测。
fallback 必须写在 @supports 外层，否则等于没写
很多人把基础色和 P3 色都塞进 @supports 块里，例如：
/* ❌ 错误：fallback 被包裹，旧浏览器完全收不到 */<br>@supports (color: color(display-p3 0 0 0)) {<br> .btn {<br> color: #cc3344;<br> color: color(display-p3 0.8 0.2 0.27);<br> }<br>}正确结构是先定义 sRGB fallback，再用 @supports 覆盖：
/* ✅ 正确：fallback 在外层，所有浏览器都生效 */<br>.btn {<br> color: #cc3344;<br>}<br>@supports (color: color(display-p3 0 0 0)) {<br> .btn {<br> color: color(display-p3 0.8 0.2 0.27);<br> }<br>}注意两点：
- 不要依赖
color: color(display-p3 ...) red这类空格分隔 fallback——整条声明会被 WebKit 直接丢弃 - 避免在
@supports内部重复定义同一属性，除非你明确想覆盖前面的值
真机调试时容易忽略的硬性前提
即使 @supports 检测通过、语法无误，颜色仍发灰，大概率卡在以下任一环节：
- HTML 缺少
<meta name="color-scheme" content="light dark">，且该标签未放在<head>最顶部——某些 iOS Safari 版本不触发 P3 渲染管线 - 父元素用了
transform、opacity或filter——强制整个层叠上下文降级为 sRGB 合成，P3 声明被绕过 - 用了
background-color: color(display-p3 ...)——这是当前最不稳定的属性，iOS Safari 和多数 WebView 中会静默映射到 sRGB 输出空间 - 设计稿里的 P3 值是直接从 Photoshop “复制 RGB” 得来——未经 Display P3 色彩空间校准，数值坐标错误，饱和度反而打折
最稳妥的验证路径是：HTTPS + 真机 + macOS/iOS + Safari 16.4+ + @supports + 单色 background-image: linear-gradient(...) + 系统广色域开启。少一个，就别指望看到真正的 P3 红。
