最常见的原因是语法错误或位置不当：缺括号、值写成true、混用prefers-contrast均导致“Invalid CSS media query”；规则未置于CSS末尾或@layer base后易被覆盖；硬编码颜色值全部失效，须改用CanvasText等系统语义色。
为什么写了 @media (forced-colors: active) 却没生效
最常见的原因是语法错误或位置不对。DevTools 里出现 “Invalid CSS media query”，基本就是这三类问题：
• @media forced-colors: active 缺外层括号
• @media (forced-colors: true) 值写错，必须是 active，不是布尔值
• 把它和 @media (prefers-contrast: high) 混用，后者只是偏好信号，不触发强制接管
还有一种隐形失效：规则写在了通用样式前面，被更早的 color: #333 覆盖了。系统级高对比度模式下，浏览器会强制替换颜色，但前提是你的 @media (forced-colors: active) 规则得真正匹配并应用上。
@media (forced-colors: active) 里能用哪些颜色值
硬编码值全部失效：#000、rgb(0,0,0)、hsl(0 0% 0%)、rgba(0,0,0,0.8) 都会被忽略。你只能用系统定义的语义色关键词：
-
CanvasText（正文文字） -
ButtonText（按钮文字） -
ButtonFace（按钮背景） -
Highlight（警示区背景） -
HighlightText（警示区文字） -
transparent在该模式下可能映射为不可见色，建议显式替换成Canvas或ButtonFace
注意：!important 无效，linear-gradient() 和 box-shadow 也会退化或清空。
立即学习“前端免费学习笔记（深入）”；
移动端 forced-colors: active 为什么经常不触发
iOS Safari 直到 17.4+ 才支持，且需同时开启三项设置：
• 增加对比度
• 降低透明度
• 使用灰度
缺一不可。只开“增加对比度”只会触发 @media (prefers-contrast: high)，而不是强制接管渲染。
Android Chrome 120+ 支持，但厂商定制系统里开关路径各异，有些叫“增强可见性”，有些藏在“辅助功能 > 显示”子菜单里。真机验证是唯一可靠方式——DevTools 的 “Emulate forced colors” 只模拟 prefers-contrast，不会清空 background-image 或降级 box-shadow。
如何组织 CSS 才保证 forced-colors 规则真正起作用
规则必须满足三个硬条件：
- 语法唯一合法写法：
@media (forced-colors: active)，不能嵌套在@supports里（@supports (forced-colors: active)永远返回false） - 必须放在
src/styles.css文件末尾，或包裹在@layer base之后；Tailwind 的@layer utilities或@layer components里写会被 JIT 编译器跳过 - 不要依赖继承，默认样式里写的
color或background-color在该媒体查询下全失效，所有关键元素（按钮、表单控件、SVG 图标）都得显式重写
最容易被忽略的是：这不是可选优化，而是 Windows 高对比主题（如“高对比度黑色”）下保障可读性的底线。只靠 prefers-contrast，等于默认用户永远不会启用系统级高对比——而现实中，这是辅助功能用户的刚需入口。
