最稳方式是用lighten()/darken()动态生成渐变色阶，但必须确保颜色变量已声明、方向值用~"@{direction}"转义，否则编译出带引号的linear-gradient()导致浏览器忽略；高饱和色需控制步长在8%~15%，避免链式调用与极值色失控。
直接用 lighten() 和 darken() 动态生成渐变色阶最稳，但必须确保颜色变量已声明、方向值被正确转义，否则编译出的 CSS 会带引号，浏览器直接忽略整个 linear-gradient() 声明。
为什么 linear-gradient(to right, @primary, lighten(@primary, 12%)) 有时不生效
常见错误是把 @direction: to right; 直接拼进函数里，比如写成 linear-gradient(@direction, ...)。Less 默认把它当字符串处理，结果产出 linear-gradient("to right", ...) —— 浏览器只认无引号的 to right，语法错误，降级为纯色背景。
- 必须用转义语法：
linear-gradient(~"@{direction}", @start-color, @end-color) -
%("@{direction}")不行，它只做格式化，不剥离引号 - 方向变量建议默认设为
@direction: to bottom;，兼容性最好；传to right或45deg都可以，但别用旧式left/top - 所有颜色变量（如
@primary）必须在 mixin 定义前声明，且不能是字符串字面量（例如"#3498db"）
怎么用 lighten()/darken() 安全算出渐变色阶
这两个函数在编译期运行，输入必须是合法 color 类型，否则可能产出 transparent 或编译失败。对高饱和色或极值色（如 #fff）调用过深，结果容易失控。
- 先查原色的 L 分量（可用在线 HSL 工具），再设步长：比如
@primary: #e74c3c;的 L≈45%，darken(@primary, 20%)就可能直接变黑，改用10%更稳妥 - 避免链式调用：
lighten(darken(@primary, 10%), 10%)因 HSL 插值非线性，结果常偏移预期 - 推荐组合：
background: linear-gradient(to right, @primary, lighten(@primary, 12%));—— 步长控制在 8%~15% 区间，视觉过渡自然，且适配多数主色 - 若需透明度微调，用
fade(@color, 90%)比手写rgba()更可靠
多色标渐变要不要塞进一个 mixin？
三色以内用固定参数的 .gradient-bg-stops() 没问题；四色以上硬塞进 mixin，逻辑易爆炸，Less 3.0 以下版本还可能因 length(@args) 判断失准而编译失败。
立即学习“前端免费学习笔记（深入）”；
- 双/三色场景：定义
.gradient-bg-stops(@stops: #f00 0%, #ff0 50%, #00f 100%)，调用时整体转义：background-image: linear-gradient(~"@{stops}"); - 拒绝用条件判断拆解 list：
if(length(@args) > 3, ...)在编译期不可靠，尤其含百分比时 - 4 色及以上渐变，直接手写 CSS 更稳；Less 只负责生成 fallback 或主题色变量
- 重复渐变（
repeating-linear-gradient）注意角度单位：写@angle: 45deg;，不能省略deg
真正难的不是写对一行 linear-gradient，而是让同一套 mixin 在换主题色、加 CSS 变量 fallback、适配 Safari 渲染、甚至输出 WebKit 前缀时都不翻车——这些分层逻辑一旦混在一起，调试成本会指数上升。
