Go go-colorful 怎样把十六进制颜色转换为Lab坐标

要把十六进制颜色转换成 Lab 坐标，核心只需要两步：先调用 colorful.Hex 得到 Color，再调用它的 Lab() 方法读取 L、a、b。解析阶段必须保留错误处理，不能把无效颜色串继续传给后续计算。

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

一、先安装依赖，确认转换链路

在 Go 模块项目中先安装库。示例使用官方模块路径，代码中的注释只解释命令用途。

# 安装 go-colorful 模块
go get github.com/lucasb-eyer/go-colorful

转换链路可以看成“文本颜色串 → Color → Lab 三元组”。Color 内部以归一化 RGB 保存颜色，再由 Lab() 完成颜色空间转换。

二、用 Hex 解析 #rrggbb 或 #rgb

colorful.Hex 会解析 HTML 风格的十六进制颜色。完整六位写法例如 #ff1034，三位缩写例如 #f0c。由于它返回错误，调用方应该在拿到结果后立刻判断 err。

package main

import (
    "fmt"
    "log"

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

func main() {
    // Hex 同时支持六位和三位 HTML 颜色写法。
    inputs := []string{"#ff1034", "#f0c"}
    for _, text := range inputs {
        color, err := colorful.Hex(text)
        if err != nil {
            // 无效输入不要继续参与坐标计算，保留原始文本便于定位。
            log.Printf("解析颜色 %q 失败: %v", text, err)
            continue
        }

        // Lab() 返回感知颜色空间中的 L、a、b 坐标。
        l, a, b := color.Lab()
        fmt.Printf("%s -> L=%.6f, a=%.6f, b=%.6f\\n", text, l, a, b)
    }
}

这里没有手动切分字符串，也没有把十六进制通道值直接当作 Lab 值。库先完成颜色解析，再按自己的颜色空间转换实现返回坐标。

三、把输入边界和错误路径分开

实际接口通常会收到表单、配置文件或数据库中的文本。建议让“解析失败”和“解析成功但坐标处于正常范围”成为两条清晰路径：先处理错误，再使用 Color。

package main

import (
    "fmt"

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

// HexToLab 只负责一次解析和坐标转换，调用方可以决定如何展示错误。
func HexToLab(text string) (l, a, b float64, err error) {
    color, err := colorful.Hex(text)
    if err != nil {
        // 用具名返回值把解析错误原样交给上层处理。
        return 0, 0, 0, fmt.Errorf("颜色 %q 无法解析: %w", text, err)
    }

    // Lab 使用 D65 参考白；若业务需要其他白点，再显式选择 WhiteRef 方法。
    l, a, b = color.Lab()
    return l, a, b, nil
}

这个封装的边界很窄：它不负责修剪用户输入、不擅自补齐缺失的 #，也不把业务层的空值规则混进颜色库调用。这样错误信息、输入清洗和展示策略可以由上层分别决定。

四、Lab 坐标该怎样理解

L 表示明度，a 和 b 表示两个颜色方向。go-colorful 的文档说明，Lab() 使用 D65 作为参考白；如果设备或流程需要另一套参考白，可以使用 LabWhiteRef，而不是把返回值手动缩放。

如果目标是比较两种颜色的视觉接近程度，应优先在 Lab 或其他 CIE 空间中计算距离，而不是直接比较 RGB 三个通道的欧氏距离。RGB 更贴近屏幕通道表达，Lab 更贴近感知上的差异表达。

五、常见问题

为什么 Hex 解析成功后还要保存 error？

因为无效字符串会让颜色对象不具备可靠语义。保留并处理 error，才能把输入问题和后续的坐标计算问题区分开。

三位颜色和六位颜色能混用吗？

可以，go-colorful 的 Hex 文档明确支持这两种 HTML hex 形式。业务接口仍建议统一输入格式，便于日志和缓存键保持稳定。

Lab 坐标可以直接当成 RGB 使用吗？

不可以。Lab 的三个值属于另一种颜色空间；如果要回到 RGB，应使用对应的反向转换接口，不要把三个数直接填入 Color{R, G, B}。

总结

这类转换不需要手写十六进制拆分或 Lab 公式：用 colorful.Hex 完成文本解析，检查错误后调用 Color.Lab() 读取坐标；需要自定义白点时再使用 LabWhiteRef。把解析、错误处理和后续颜色比较分层，接口就更容易复用。