如何使用ImageSharp从流提取主色 替代Linux Docker下的System.Drawing/ColorThief

问题根因 #

1. 空引用异常是因为旧版本参考代码适配的是ImageSharp 1.x版本，2.0+版本对OctreeQuantizer的内部实现和构造逻辑做了重构，直接传入MaxColors=1的QuantizerOptions会触发内部未初始化对象的调用。
2. 始终返回白色的问题大多是因为未处理图片的Alpha透明通道：量化时会将透明像素默认计算为白色，若图片透明区域占比过高就会返回FFFFFF。

实现步骤 #

1. 安装依赖 #

你需要先安装对应NuGet包：

Install-Package SixLabors.ImageSharp
Install-Package SixLabors.ImageSharp.Processing

2. 核心实现代码 #

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;
using SixLabors.ImageSharp.Processing.Processors.Quantization;

public static Color GetDominantColor(Stream imageStream)
{
    // 加载图片时统一使用Rgba32像素格式，兼容透明通道处理
    using var image = Image.Load<Rgba32>(imageStream);
    
    // 量化器配置：MaxColors设为2规避单颜色量化的内部bug，关闭抖动避免干扰颜色统计
    var quantizer = new OctreeQuantizer(new QuantizerOptions
    {
        MaxColors = 2,
        Dither = null
    });
    
    // 生成量化调色板
    var frameQuantizer = quantizer.CreatePixelSpecificQuantizer<Rgba32>(Configuration.Default);
    frameQuantizer.BuildPaletteAndQuantizeFrame(image.Frames.RootFrame, image.Bounds);
    
    // 取占比最高的颜色，过滤完全透明像素
    var dominantColor = frameQuantizer.Palette.Span[0];
    if (dominantColor.A == 0 && frameQuantizer.Palette.Length > 1)
    {
        dominantColor = frameQuantizer.Palette.Span[1];
    }
    
    return dominantColor;
}

补充说明 #

• 如需输出十六进制颜色字符串，可通过$"{dominantColor.R:X2}{dominantColor.G:X2}{dominantColor.B:X2}"格式化得到结果
• ImageSharp为纯托管实现，Docker环境无需额外安装libgdiplus等原生依赖，直接打包即可运行，完全适配Linux容器场景
• 处理大尺寸图片时，可先将图片等比压缩到200px以内再提取主色，可大幅提升处理速度且不影响主色判断准确率

内容的提问来源于stack exchange，提问作者Ghimpu Lucian Eduard