应使用 mix() 替代 lighten()/darken() 实现可控渐变色阶，避免发灰失真；方向参数需转义，多色渐变须专用 mixin；CSS 变量 fallback 需手动分层，主题与环境一致性是核心难点。
用 mix() 替代 lighten()/darken() 生成更可控的渐变色阶
直接写 linear-gradient(to bottom, @primary, lighten(@primary, 20%)) 看似省事，但高饱和色（如 #00f）用 lighten() 容易发灰、失真；#fff 或 #000 更会直接卡在边界值上毫无变化。真正稳定的做法是用 mix() 显式控制混合比例。
-
mix(@color1, @color2, 60%)比lighten(@color, 20%)更可预测——它按通道加权平均，不依赖 HSL L 值，对任何合法颜色都有效 - 常用组合：
mix(@primary, #ffffff, 20%)模拟“提亮”，mix(@primary, #000000, 15%)模拟“加深”，数值越小越接近原色 - 避免链式调用：
mix(mix(@a, @b, 30%), @c, 50%)可读性差且易出错，应先算出中间色变量再使用 - 注意 alpha：如果
@primary是rgba(…)，mix()会连透明度一起混合，结果可能比预期更透——必要时先用fadeout(@color, 0%)转为不透明色
写 .gradient-linear() mixin 时必须转义方向参数
编译后出现 background-image: linear-gradient("to right", ...) 这种带引号的写法，浏览器直接忽略整条声明——不是语法错，是 Less 把 @direction 当字符串字面量拼进去了。
- 方向参数必须用
~"to right"或%("to right")转义，不能直接写to right（Less 会尝试解析为变量）或"to right"（输出带引号） - 旧版 WebKit（Android 4.3/Safari ≤6）不认
to right，得映射为left；可在 mixin 内部加判断：.gradient-linear(~"left", ...)专供前缀版本 - 别设空默认值：
@direction: ""会导致linear-gradient(, ...)，语法非法；稳妥做法是@direction: ~"to bottom" - 多色标字符串里含
calc()时，整个表达式要用~"calc(100% - 2px)"包裹，否则 Less 解析失败
三色及以上渐变必须另写 .gradient-bg-stops()，别硬塞进两色 mixin
试图用 .gradient-bg(@a, @b, @c) 支持三色，很快会陷入默认值冲突、调用歧义、维护混乱——比如 @c 到底是终点色还是中间色？停靠位置怎么传？
- 专用函数接口清晰：
.gradient-bg-stops(@stops: #f00 0%, #ff0 50%, #00f 100%)，参数是逗号分隔的字符串，语义明确 - 内部用
each()遍历@stops生成色标列表，比手动拼接"#{@a} 0%, #{@b} 50%, #{@c} 100%"更安全，避免括号/逗号解析错误 - Safari 对相邻色标位置差小于 2% 的多色渐变仍有渲染模糊 Bug（2026 年仍偶发），建议写成
#333 48%, #334 52%而非#333 49%, #334 51% - 方向仍复用统一逻辑：
@direction: ~"to right"，和两色版保持一致，降低使用者记忆成本
CSS 变量 fallback 必须手动分层，Less 不支持运行时判断
想让 .gradient-bg() 自动降级到 var(--bg-start) 或静态色？Less 编译期无法知道 CSS 变量是否存在，所谓“智能 fallback”全是假象。
立即学习“前端免费学习笔记（深入）”；
- 必须拆成两个独立 mixin：
.gradient-bg-fallback()输出完整降级链（纯色 → 带前缀渐变 → 标准渐变），.gradient-bg-css-vars()只输出background-image: var(--bg-gradient) - 调用时显式并列写：
.my-card { .gradient-bg-fallback(); .gradient-bg-css-vars(); }，把控制权交给开发者 - 别在 mixin 内部用
if()判断iscolor(@var)——它只能测 Less 变量是否已定义且为 color 类型，对var(--x)永远返回 false - 真正难的不是写对一个渐变，而是让所有渐变在主题切换、暗色模式、CSS 变量注入、移动端 Safari 渲染之间保持行为一致——前缀、方向、停靠点这三处，任一漏掉都可能让渐变在某个环境里完全消失
