color-gamut媒体查询仅检测设备默认色彩空间能力，返回sgamut、pgamut或rec2020三值，不反映校准状态、实际渲染精度或环境影响，依赖系统与浏览器共同上报，需配合display-p3色值、ICC配置、Canvas显式设置等全链路适配才能保障广色域一致呈现。
color-gamut媒体查询到底能检测什么
color-gamut 媒体查询不是测你屏幕“准不准”，而是问浏览器：“这台设备的默认色彩空间能不能显示广色域？” 它只返回三个值：sgamut（sRGB）、pgamut（P3）、rec2020（极少见）。它不关心校色状态、亮度或环境光，也不反映实际渲染偏差——只是个粗粒度的能力提示。
常见错误现象：@media (color-gamut: p3) 在未校准的MacBook上返回true，但用户看到的红色可能依然发灰；在某些Android旗舰机上却返回sgamut，尽管硬件支持P3——因为系统或WebView没开启广色域渲染通道。
- 它依赖操作系统和浏览器共同上报，Chrome 105+、Safari 12.1+ 支持较稳，Firefox目前不支持
- 不能替代
color-scheme或prefers-reduced-motion，三者解决的问题完全不同 - 值为
pgamut≠ 你用color(display-p3 ...)就一定显示正确——还得看CSS是否启用、图像是否嵌入P3配置文件、GPU合成是否绕过sRGB转换
怎么用color-gamut做渐进式颜色适配
别把它当开关，当成“多一层保险”。核心逻辑是：默认用rgb()或十六进制保底，仅在确认设备+浏览器支持时，才加载更饱和的display-p3色值。
示例写法：
立即学习“前端免费学习笔记（深入）”；
@media (color-gamut: p3) {
.btn-primary {
background-color: color(display-p3 0.85 0.2 0.3);
}
}
@media (color-gamut: rec2020) {
.btn-primary {
background-color: color(rec2020 0.85 0.2 0.3);
}
}
注意点：
-
color(display-p3 ...)的参数是0–1范围的线性值，不是sRGB gamma压缩后的值——直接把#cc3344换算过去会偏暗偏浊 - 不要在
@media (color-gamut: p3)里覆盖所有颜色，优先选品牌主色、图标高亮、数据可视化中的关键色 - Webpack/Vite构建时，
postcss-preset-env可自动降级color(display-p3)为rgb()，但color-gamut媒体查询本身不会被降级——得你自己写fallback
为什么display-p3颜色在Chrome里看起来比Safari淡
这不是color-gamut的问题，是渲染管线差异。Safari对display-p3支持早且激进，默认走原生P3合成；Chrome直到v117才默认启用P3输出，且受--force-color-profile=p3启动参数或系统设置影响。
典型表现：
- 同一段
color(display-p3 1 0 0)，Safari显示为鲜红，Chrome显示为偏橙红甚至带灰调 - DevTools里“Rendering”面板勾选“Emulate wide gamut display”后，Chrome才接近Safari效果——说明它默认没走P3路径
- macOS系统设置中关闭“在显示器上使用广色域”，
color-gamut立刻退回到sgamut，但已声明的display-p3色值仍会被解析（只是降级渲染）
这意味着：你不能靠color-gamut查询结果反推当前渲染精度，它只是能力声明，不是实时渲染上下文。
真正影响颜色一致性的其实是这些地方
color-gamut只是浮在表面的一层探测，底下还有三处更常出问题：
-
<img>标签加载的PNG/JPEG是否内嵌ICC配置文件？没嵌的话，即使color-gamut: p3为true，浏览器也按sRGB解码 - CSS
background-image: linear-gradient(...)里的色值永远按当前色彩空间解释——如果父容器没设color-profile，梯度会在sRGB下计算再映射，导致过渡生硬 - Canvas 2D上下文默认是sRGB，
ctx.fillStyle = 'color(display-p3 1 0 0)'会被静默转成sRGB值；要用canvas.getContext('2d', { colorSpace: 'display-p3' })显式开启（仅Chrome 119+支持）
设备越新，color-gamut越容易返回pgamut，但颜色是否真实一致，取决于整条链路有没有一处断掉——而那处断点，往往不在媒体查询里。
