最轻量方案是用CSS变量存静态色值，动态生成需JS计算后通过setProperty写入；HSV/HSL易混淆，须校验输入范围并确认库默认模型；读取需RAF或本地缓存；深色模式应基于基准色+相对规则生成，变量建议加命名空间前缀。
怎么用 CSS 变量动态生成颜色代码
直接把颜色值存在 :root 里，再用 var(--color-primary) 调用，是最轻量的方案。但“生成器”意味着要实时算出新颜色（比如明度调高 10%、饱和度减半），这时候不能只靠静态变量——得用 JS 计算后写回 CSS 变量。
- 别在 JS 里拼接字符串塞进
style属性，那样绕过 CSS 变量机制，后续无法被其他规则复用 - 正确做法是：用
document.documentElement.style.setProperty('--color-result', '#ff6b6b') - 如果要批量更新（比如同时改主色+辅助色+文字反色），一次 setProperty 比多次更稳，避免中间态闪烁
HSV/HSL 转换时最容易错的三个地方
CSS 原生只认 rgb() 和 hsl()，但用户拖滑块调“色相/饱和度/明度”时，直觉是 HSV 模型。HSL 和 HSV 的 V（明度）和 L（亮度）不是一回事，混用会导致调亮变灰、调暗发黑。
- 浏览器解析
hsl(120, 100%, 50%)是标准 HSL，不是 HSV；用第三方库（如chroma.js）时务必确认它默认输出的是 HSL 还是 HSV - 手动实现转换？先查
hslToRgb算法，别抄错L和V的权重公式——网上很多旧代码把V当L用 - 输入值范围必须校验：
h是 0–360，s和l是 0–100%，超限会静默失败或渲染异常
为什么 getComputedStyle 读不到刚设的 CSS 变量
执行 document.documentElement.style.setProperty('--color-temp', '#abc') 后立刻 getComputedStyle(document.documentElement).getPropertyValue('--color-temp')，返回空字符串——这不是 bug，是 CSSOM 更新时机问题。
- 变量写入是异步生效的，得等样式计算周期完成；简单解法是加个
requestAnimationFrame再读 - 更可靠的做法：不依赖读取，把 JS 侧的颜色值单独存一份变量（如
currentColor），CSS 变量仅作“下发通道” - 调试时想验证是否写入成功？打开 DevTools → Elements → :root → 查看 Styles 面板里是否有该变量，比 JS 读取更直观
深色模式下颜色工具的兼容性陷阱
用 @media (prefers-color-scheme: dark) 切换主题时，如果只覆盖部分变量（比如只改 --bg），而生成逻辑仍基于原始 --color-primary，结果可能在深色模式下生成出不可见的浅灰文字。
立即学习“前端免费学习笔记（深入）”；
- 别让生成逻辑“假设”某个变量始终是亮色；加一层判断：
if (window.matchMedia('(prefers-color-scheme: dark)').matches) - 推荐方案：所有可生成的颜色，都基于一个“基准色变量”（如
--base-hue）+ 一套相对规则（如“文字用 L=20%”，“背景用 L=90%”），而非固定 RGB 值 - 移动端 Safari 对
color-scheme: dark支持不一致，测试时别只看 Chrome；真机上matchMedia返回值可能延迟触发
变量名要不要加命名空间前缀（比如 --tool-hue 而不是 --hue）？要看是否嵌入第三方页面——没加的话，容易被全局样式污染，而且调试时根本分不清是谁写的变量。
