Go go-colorful 怎样在HCL空间混合两种颜色

如果两个颜色直接在 RGB 三个通道上做平均，渐变经常会显得发灰或亮度变化不自然。go-colorful 提供了 BlendHcl，可以把两个 Color 放到 HCL（CIE-L*C*h°）空间中插值，再得到一个中间颜色。实际使用时要把握三件事：t 决定当前位置，色相是环形角度，HCL 插值结果还可能落到 RGB 无法显示的范围。

官方地址：https://pkg.go.dev/github.com/lucasb-eyer/go-colorful

一、先明确这个混色模式解决什么问题

渐变生成通常有两个约束：一是起点和终点必须保持可识别，二是中间变化不能出现无意的亮度跳变。RGB 适合描述屏幕通道，但三个通道的直线距离并不等于人眼看到的差异。HCL 把 Lab 空间改成极坐标，便于把“沿着色相转动，同时控制色度和明度”表达出来。

这不是说 HCL 对所有场景都更好。如果你的任务是直接写入像素通道，RGB 仍然是最终输出格式；HCL 更适合作为中间的决策空间。这个边界决定了后面的代码结构：先在 HCL 中混合，再回到 RGB 做显示或编码。

二、把 HCL 当作插值边界

先安装模块，然后用两个颜色创建一个 HCL 插值。BlendHcl 是 Color 的方法，第二个参数是终点颜色，第三个参数是插值比例。

# 安装 go-colorful，供 Go 模块导入
go get github.com/lucasb-eyer/go-colorful

package main

import (
    "fmt"
    "log"

    "github.com/lucasb-eyer/go-colorful"
)

func main() {
    // Hex 负责把 HTML 风格颜色文本解析成 Color。
    start, err := colorful.Hex("#2f80ed")
    if err != nil {
        log.Fatal(err)
    }
    end, err := colorful.Hex("#f2994a")
    if err != nil {
        log.Fatal(err)
    }

    // t=0.5 取 HCL 路径的中间位置，而不是逐通道平均 RGB。
    middle := start.BlendHcl(end, 0.5)
    fmt.Printf("middle=%s\\n", middle.Hex())
}

这里的 t 可以看作路径上的位置：0 表示起点，1 表示终点，0.25、0.5、0.75 则分别取中间位置。不要把它误认为百分比字符串，也不要在调用前先把颜色拆成 0 到 255 的整数。

三、理解 h、c、l 三个旋钮

HCL 可以写成 Hcl(h, c, l)。其中 h 是色相角，通常按 0 到 360 度理解；c 表示离中性轴的距离，也就是色彩浓度；l 表示明度。go-colorful 文档把 HCL 作为 CIE-L*a*b* 的极坐标表达，因此它适合承载“保持明度、改变色相”这类设计意图。

如果只想生成一个受控起点，也可以先显式创建 HCL 颜色，再与另一个颜色混合：

package main

import (
    "fmt"

    "github.com/lucasb-eyer/go-colorful"
)

func main() {
    // h 是色相角，c 是色度，l 是明度；数值先保持在业务允许的范围内。
    warm := colorful.Hcl(28, 0.65, 0.58)
    cool := colorful.Hcl(218, 0.55, 0.58)

    // 保持相近明度，可以让渐变的明暗变化更可控。
    middle := warm.BlendHcl(cool, 0.5)
    h, c, l := middle.Hcl()
    fmt.Printf("h=%.1f c=%.3f l=%.3f\\n", h, c, l)
}

方法返回值的变量名要按库的签名确认，不要只凭变量名猜顺序。文章中的 l, c, h 只是为了对应 HCL 的语义；在项目里应以当前依赖版本的 Go 文档为准，并让命名与调用约定保持一致。

四、色相跨过 0 度时不要照搬普通线性插值

色相是一个环，359 度和 1 度其实很接近。如果把两个角度当作普通数字直接平均，可能会沿着较长的方向绕一圈。BlendHcl 的价值之一，就是把插值交给颜色空间相关的方法处理，而不是让业务代码手写角度差。

工程上仍要先确定你想要的视觉路径：从红色到黄色，还是从红色绕过紫色再到黄色。对于配色系统，建议把起止颜色和 t 固化为数据，再以少量样本检查结果是否符合设计意图；不要在业务代码里同时混用 RGB 平均、HSV 平均和 HCL 平均。

五、处理落出 RGB 色域的中间色

CIE 颜色空间的计算结果不一定都能被 RGB 显示器表示。尤其是输入颜色来自用户、随机调色或高色度 HCL 值时，中间结果可能在数学上成立，但转成 RGB 后出现超出范围的通道。go-colorful 提供 IsValid 判断颜色是否仍是有效 RGB 表示，也提供 Clamped 把它收回到附近的可表示颜色。

package main

import (
    "fmt"

    "github.com/lucasb-eyer/go-colorful"
)

// safeHex 返回可直接用于显示的十六进制颜色，并保留色域修正策略。
func safeHex(start, end colorful.Color, t float64) string {
    middle := start.BlendHcl(end, t)
    if !middle.IsValid() {
        // Clamped 只做边界收口，不代表修正后的颜色仍完全等价。
        middle = middle.Clamped()
    }
    return middle.Hex()
}

func main() {
    // 这里的输入代表两个已经解析好的 Color。
    start := colorful.Hcl(190, 0.75, 0.62)
    end := colorful.Hcl(35, 0.75, 0.62)
    fmt.Println(safeHex(start, end, 0.5))
}

Clamped 是一个明确的取舍：它让结果更接近当前设备能够显示的 RGB 范围，但会改变原始 HCL 位置。若业务要求颜色科学上的精确性，不能默默丢弃这个信息；可以把是否发生过收口作为状态返回，或者在日志中记录输入和插值比例。

六、把模式封装成稳定的渐变函数

当页面、报表或图表都需要渐变时，最好把插值和色域策略集中起来。调用方只提供起点、终点和采样数量，避免每个业务模块各自决定是否检查有效性。

package palette

import "github.com/lucasb-eyer/go-colorful"

// HCLGradient 生成 count 个颜色；结果统一转换到可显示 RGB 范围。
func HCLGradient(start, end colorful.Color, count int) []colorful.Color {
    if count 

这个函数没有把输入清洗、主题命名或持久化混进来。它只负责 HCL 插值和 RGB 色域边界，正好对应一个小而清楚的架构模式：中间颜色空间负责表达，显示层负责收口，业务层决定是否记录修正。

七、什么时候应该选 HCL，什么时候不该选

常见问题

BlendHcl 的 t 可以传大于 1 的值吗？

不要把它当作无界外推参数。文章中的渐变函数把 t 固定在 0 到 1 之间；如果业务需要外推，应先确认库方法的边界语义，并自行定义超出范围后的策略。

为什么 HCL 混色后还要回到 RGB？

HCL 是更适合表达颜色变化的中间空间，而屏幕、图片文件和多数前端颜色值最终仍以 RGB 表达。两者分别承担“怎么计算”和“怎么显示”。

Clamped 会不会让渐变出现色差？

会有这个可能。它的作用是把不可显示结果映射到附近的可显示颜色，因此应把它视为工程上的边界收口，而不是数学上完全不变的转换。

总结

用 go-colorful 在 HCL 空间混合两个颜色，核心是 start.BlendHcl(end, t)：让 HCL 负责更自然的中间路径，让 RGB 负责最终显示。真正可靠的实现还要处理两个边界：色相是环形角度，CIE 空间的结果可能超出 RGB 色域。把 IsValid 和 Clamped 集中在显示适配层，配色逻辑就能保持清楚，也更容易在不同界面复用。