必须搭配calc()才能真正衍生UI调色板，因from仅拆解通道（h/s/l），calc()才实现明暗、饱和度等动态调整；语法要求严格，空格、斜杠、单位错误均导致静默失效。
直接用 hsl(from <color> h s calc(l ± N)) 就能生成整套 UI 调色板，不需要 JS、不依赖构建工具，但必须搭配 calc() 才生效，且空格、斜杠、单位一个都不能错。
为什么只写 hsl(from var(--primary)) 不行
因为 from 只是“拆解”颜色通道，不是“变换”。hsl(from var(--primary) h s l) 等价于原样输出基础色——所有状态色都一样，悬停、禁用、激活全无区别。
真正起作用的是 calc() 对通道的运算：
-
calc(l - 10)：变暗（适合 hover / active） -
calc(l + 15)：提亮（适合 disabled 文字） -
calc(s * 0.7)：降饱和（避免高饱和在浅背景下发刺） -
max(15%, calc(l - 30))：防亮度归零导致渲染异常（OLED 屏易发灰或不可见）
hsl(from) 的语法雷区必须避开
浏览器对相对颜色语法极其敏感，错一个字符就静默失效，且不报错：
立即学习“前端免费学习笔记（深入）”；
-
hsl(from var(--primary) h s calc(l - 10))✅（from和变量之间有空格） -
hsl(fromvar(--primary) h s calc(l - 10))❌（缺空格 → 整个声明被忽略） -
rgb(from #000 r g b, 0.6)❌（alpha 必须用/引入） -
rgb(from #000 r g b / 0.6)✅ -
calc(l + 20%)❌（l是 0–100 数值，不是百分比） -
calc(l + 20)✅
如何组织变量实现多主题+深色模式兼容
只定义 --primary-color 远不够。一套可用的 UI 调色板至少需分层管理：
-
基础色层：
--primary、--secondary、--success等（品牌输入） -
语义层：
--text-primary、--border-light、--bg-surface（设计系统约定） -
场景层：
@media (prefers-color-scheme: dark) { :root { --text-primary: #f8f9fa; } }（必须重设，不能靠继承）
运行时切换主题时，只改 document.documentElement.style.setProperty('--primary', '#409eff') 没用——它不会自动推导出 --primary-light-3 或 --text-on-primary。这些必须靠 hsl(from) 在 CSS 中实时计算，或提前用工具（如 TweakCN、FAST 的 ComponentStateColorPalette）生成并注入变量。
边界情况最容易翻车
真正难的不是写出一行正确的 hsl(from)，而是处理人眼感知非线性带来的问题：
- 当基础色
l < 15%（极暗）时，calc(l - 20)会负溢出，浏览器可能渲染为黑色或透明，UI 失效 - 当
s > 95%（近纯色）时，calc(s * 0.3)后仍可能过饱和，在 OLED 屏上出现色块抖动 - 深色模式下未重设
--text-on-primary，导致白色文字落在浅灰背景上对比度不足（AA 标准要求 4.5:1）
这些地方一旦漏掉 clamp()、max() 或无障碍验证，上线后在特定设备或环境下就会“突然不可用”。
