Go go-colorful 怎样生成具有区分度的配色集合

如果程序需要给玩家、标签、图表系列或多租户对象分配颜色，直接循环随机 RGB 往往会生成几组肉眼很接近的颜色。go-colorful 已经提供了面向调色板的函数：通用场景优先试 SoftPalette，只在更看重速度时选择 FastHappyPalette；需要限定暖色、低饱和度等风格时，再使用 SoftPaletteEx。

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

生成“具有区分度”的集合，不等于保证任意数量的颜色都适合任意屏幕。文章中的代码把数量、颜色空间、返回错误和回退路径都作为运行时决策的一部分。

先判断需求：随机颜色还是可区分调色板

单个随机颜色只需要满足色相或明暗范围；一组颜色则要避免相邻成员过近。官方文档将普通调色板和 Fast 调色板区分开：普通方案使用 CIE 相关颜色空间，更关注感知上的差异；快速方案在 HSV 空间内分散色相，速度更快，但不一定同样好看。

用 SoftPalette 生成一组可区分颜色

SoftPalette(colorsCount) 返回 []colorful.Color 和 error。它适合把“给定数量的颜色”当成一个可能失败的资源申请来处理，而不是假设任何数量都能得到同样质量的结果。

package main

import (
	"fmt"
	"log"

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

func main() {
	// 颜色数量来自业务对象数量；实际项目中应限制最大值，避免请求过大的调色板。
	colors, err := colorful.SoftPalette(8)
	if err != nil {
		// 非快速调色板可能因数量过大或搜索空间不足失败，不能忽略这个错误。
		log.Fatalf("生成调色板失败: %v", err)
	}

	for index, color := range colors {
		// Hex 适合写入 JSON、CSS 或前端配置，索引保留对象到颜色的稳定映射位置。
		fmt.Printf("%d: %s\n", index, color.Hex())
	}
}

这里的关键不是把结果打印出来，而是保留失败分支。若业务不能因为调色板失败而终止，可以把 log.Fatalf 换成“缩小数量后重试”或“读取预置颜色”的回退逻辑，但不要静默返回一组空颜色。

需要可重复输出时固定随机源

调色板算法包含随机采样时，同样的数量不一定每次得到同一组颜色。报表导出、快照测试和前后端共享配置通常需要稳定结果，可以使用带随机源的版本。随机源只负责复现，不会把一个过窄的颜色空间变成无限可用。

package main

import (
	"fmt"
	"math/rand"

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

func stablePalette(count int, seed int64) ([]string, error) {
	// 固定 seed 让测试和配置生成可复现；生产环境不要把它误当作安全随机数。
	source := rand.New(rand.NewSource(seed))
	colors, err := colorful.SoftPaletteWithRand(count, source)
	if err != nil {
		return nil, fmt.Errorf("生成稳定调色板: %w", err)
	}

	result := make([]string, 0, len(colors))
	for _, color := range colors {
		// 只保存十六进制表示，避免把库内部浮点值直接暴露给调用方。
		result = append(result, color.Hex())
	}
	return result, nil
}

如果颜色需要跟对象 ID 长期绑定，还应把生成后的结果持久化，而不是每次启动服务都重新生成。固定种子只能保证同一实现、同一参数下的可复现性，不能替代配置版本管理。

速度优先时使用 FastHappyPalette

FastHappyPalette 不返回 error，调用也更短。它用 HSV 空间让颜色沿色相分布，适合实时交互中快速给出一组“看起来比较活泼”的颜色；但官方文档也明确提示，快速版本不一定漂亮。如果颜色要承载数据比较，优先回到 SoftPalette。

func fastLabels(count int) []string {
	// 快速方案适合临时预览；调用方仍应限制 count，避免界面颜色过多难以阅读。
	colors := colorful.FastHappyPalette(count)
	labels := make([]string, 0, len(colors))
	for _, color := range colors {
		// Hex 输出可以直接传给前端或日志，避免输出难读的浮点三元组。
		labels = append(labels, color.Hex())
	}
	return labels
}

一个实用判断是：如果颜色只是加载态、临时标记或交互预览，速度和低成本更重要；如果颜色会被用户用来比较曲线、区分状态或阅读很久，则需要关注感知上的均匀性和对比度，而不是只看函数名里的 Fast。

用 SoftPaletteEx 限定暖色范围

品牌看板或主题图表经常要求“都是暖色，但彼此仍要分得开”。SoftPaletteEx 的 CheckColor 会接收 Lab 坐标 l、a、b，返回 true 才允许候选颜色进入目标区域。官方示例还建议：约束拒绝了很大一部分颜色空间时，把 ManySamples 设为 true。

func warmPalette(count int) ([]colorful.Color, error) {
	// 在 Lab 坐标转为 HCL 后筛出偏暖、亮度适中的颜色区域。
	isWarm := func(l, a, b float64) bool {
		hue, chroma, lightness := colorful.LabToHcl(l, a, b)
		return hue > 10 && hue  0.10 && chroma 

Iteration 官方文档给出的有效范围是 5 到 100。可以先从 30 或 50 开始，再根据生成耗时和颜色稳定性调整。若 count 过大，或者 CheckColor 把空间限制得过窄，仍然可能返回 error。

生成失败时的回退路径

发布到线上前，建议把生成调色板单独封装，按“原方案、降低数量、预置方案”顺序处理。回退应记录原因，方便发现颜色约束是不是过窄；不要因为一次生成失败就悄悄改成完全不同的品牌色。

func paletteOrFallback(count int) []string {
	// 先尝试感知上更合适的方案，失败时减少数量，最后才使用固定预置值。
	colors, err := colorful.SoftPalette(count)
	if err != nil && count > 4 {
		colors, err = colorful.SoftPalette(4)
	}
	if err != nil {
		// 预置值是可审查、可版本化的最后防线，不依赖运行时随机结果。
		return []string{"#2457A6", "#D97706", "#15803D", "#9333EA"}
	}

	result := make([]string, 0, len(colors))
	for _, color := range colors {
		// 统一输出格式，保证回退值和算法值对调用方表现一致。
		result = append(result, color.Hex())
	}
	return result
}

如果颜色数量是业务数据的一部分，降低数量前还应明确哪些对象可以共享颜色；如果不能共享，就应该在数据层保存颜色映射并提前扩充预置集合。这样回退不会在页面上制造“同一对象换色”的突兀变化。

上线前要确认的三个信号

• 数量信号：记录请求的 count、最终生成数量和 error；持续失败通常说明需求规模或约束范围不合理。
• 视觉信号：对图表类场景抽样检查明暗、色盲可辨识性和文字对比度；调色板区分度不等于无障碍对比度。
• 稳定性信号：需要跨请求一致时使用带随机源的函数或持久化结果，不要在每次渲染时重新生成。

常见问题

SoftPalette 一定能生成任意数量的颜色吗？

不能。官方文档说明非快速方案在请求数量过大时可能失败，因此调用方必须处理 error，并准备减少数量或使用预置集合。

FastHappyPalette 和 SoftPalette 应该怎么选？

实时预览、临时标签可以优先 Fast 版本；需要做数据比较、长时间阅读或强调感知差异时，优先 Soft 版本。

SoftPaletteEx 的 ManySamples 为什么要打开？

当 CheckColor 拒绝了很大一部分颜色空间时，更多样本有助于找到可用候选，但会增加耗时。约束宽松时不必默认打开。

总结

go-colorful 生成区分色集合的核心是先选对函数，再承认生成可能失败：通用需求使用带 error 的 SoftPalette，速度优先使用 FastHappyPalette，风格约束使用 SoftPaletteEx。把颜色数量、随机可复现性、失败回退和上线后的对比度检查一起设计，才能让“随机颜色”真正变成可维护的配色集合。