必须拆解HSL为--h、--s、--l三个独立变量，才能在CSS中安全进行calc()运算；否则Safari≤15.4会静默失效，且无法实现可维护、响应式、兼容旧浏览器的主题系统。
直接拆解 HSL 为 --h、--s、--l 三个独立变量，再用 calc() 派生明暗变体，是唯一能兼顾可维护性、响应式主题和旧浏览器兼容的路径；手写 HEX 或在 hsl() 里嵌套 calc() 会掉进 Safari ≤15.4 静默失效的坑。
为什么必须把 H/S/L 拆成三个独立 CSS 变量
只有拆开才能在任意地方做可预测的数学运算。比如按钮悬停变暗，只需 calc(var(--l) - 10%)；禁用态提亮+降饱和，就是 calc(var(--l) + 15%) 和 calc(var(--s) * 0.3)。
-
--color-primary: hsl(210, 85%, 60%)这种单变量写法，后续所有派生色都得靠 JS 或构建工具解析，CSS 层完全无法计算 -
hsl(from var(--primary) h s calc(l - 10))看起来简洁，但 Safari ≤15.4 不支持，整条规则静默失效 -
hsl()的l参数是 0–100 的纯数字（不是百分比），所以calc(var(--l) + 20)合法，calc(var(--l) + 20%)会被忽略
如何安全生成深浅阶梯色且不翻车
只调 l 才能保证同色系连贯性。人眼对明暗变化最敏感，固定 --h 和 --s 后仅调节 --l，所有变体都落在视觉“灰阶轴”上，不发灰、不跳色、对比度可控。
- 浅色背景上的文字建议用
calc(var(--l) + 25%)，但上限封顶92%，否则泛白刺眼 - 深色背景上的主色建议用
calc(var(--l) - 25%)，下限卡死15%，避免失色或渲染不可控 - 别用
rgba(var(--color-primary), 0.8)——CSS 变量不能直接塞进函数参数，会报Invalid property value
Safari ≤15.4 兼容性怎么绕过去
新版相对颜色函数对空格、斜杠、单位极其敏感，错一个字符整条声明就被忽略，且浏览器不报错。稳妥做法不是赌兼容性，而是提前算好并声明为独立变量。
立即学习“前端免费学习笔记（深入）”；
-
hsl(from var(--primary) h s calc(l - 10))✅，hsl(fromvar(--primary) h s calc(l - 10))❌（from和变量之间缺空格） - alpha 必须用
/引入：rgb(from #000 r g b / 0.6)✅，rgb(from #000 r g b, 0.6)❌ - 推荐写法：
:root { --h: 210; --s: 85%; --l-base: 55%; --l-dark: 30%; --l-light: 85%; --l-disabled: 85%; --s-disabled: 30%; } .btn { background: hsl(var(--h), var(--s), var(--l-base)); } .btn:hover { background: hsl(var(--h), var(--s), var(--l-light)); } .btn:disabled { background: hsl(var(--h), var(--s-disabled), var(--l-disabled)); }
命名与边界控制最容易被忽略的点
变量名用功能语义（如 --l-dark）而非数值语义（如 --l-30），换设计规范时不用猜含义；禁用态推荐同时降饱和+提亮度，比单调高亮度更符合“弱化交互”的视觉意图。
- 浅色变体可同步略降饱和度（如
calc(var(--s) - 10%)），避免过“粉” - 深色变体可略提饱和（如
calc(var(--s) + 5%)），防止发闷 - 若需动态响应主题切换，JS 读取应统一用
getComputedStyle(document.documentElement).getPropertyValue('--l-dark') - 用
@supports (color: oklch(0 0 0))包裹高保真逻辑，Safari 当前仅支持到 16.4+
