Go image 怎样读取不同颜色模型的像素

我第一次把 Go 的图片处理接到多种输入格式时，最容易写错的地方不是解码，而是把 image.Image 误当成了某一种具体图片类型。PNG 可能得到 RGBA，JPEG 常见的是 YCbCr，灰度图片又可能是 Gray；如果在业务代码里直接做类型断言，换一种输入就会失效。

更稳妥的做法是把 ColorModel 当作模型信息，把 At(x, y) 当作像素入口。普通统计、采样和颜色判断直接调用 At().RGBA()；只有确实需要灰度值或某种结构体字段时，才用 image/color 的模型转换拿到明确类型。

记住一条主线：先用 Bounds() 确定坐标范围，再用 At() 取得 color.Color，最后根据用途选择 RGBA() 的统一通道或 GrayModel、RGBAModel、NRGBAModel 的具体转换。

image.Image 的三个入口分别负责什么

image.Image 是一个小接口，核心只有颜色模型、矩形范围和按坐标取色三个方法。它的价值在于调用方不需要知道底层是 *image.RGBA、*image.Gray 还是其他实现。

type Image interface {
    // ColorModel 描述图像使用的颜色模型，不等于某个具体像素结构体。
    ColorModel() color.Model
    // Bounds 返回图像坐标范围，左上角不一定是 (0, 0)。
    Bounds() Rectangle
    // At 按真实坐标返回一个可继续转换的颜色值。
    At(x, y int) color.Color
}

ColorModel() 适合帮助你决定“后续要不要转换”，而不是让业务逻辑写成一串脆弱的具体类型判断。Bounds() 负责告诉你合法坐标，At() 才是取得像素颜色的入口。对一个只做取样或统计的函数来说，通常只需要后两个方法。

为什么 At().RGBA 可以统一 Gray 和 RGBA

color.Color 接口提供 RGBA()，返回红、绿、蓝、透明度四个通道。每个通道用 uint32 表示，取值范围是 0 到 65535。因此，业务代码可以把不同来源的颜色先归一到同一套通道，再做亮度、透明度或直方图处理。

package main

import (
    "fmt"
    "image"
)

// pixel16 统一读取任意 image.Image 在一个坐标上的 16 位通道。
func pixel16(img image.Image, x, y int) (uint32, uint32, uint32, uint32) {
    // At 可能来自 Gray、RGBA、YCbCr 等不同实现，RGBA 负责统一转换。
    r, g, b, a := img.At(x, y).RGBA()
    return r, g, b, a
}

func printPixel(img image.Image, x, y int) {
    r, g, b, a := pixel16(img, x, y)
    // 输出保持 16 位精度，避免过早截断影响后续计算。
    fmt.Printf("pixel=(%d,%d) rgba16=(%d,%d,%d,%d)\\n", x, y, r, g, b, a)
}

这里不需要先判断图片是不是 Gray。Gray 的灰度值会被映射到 RGB 通道，RGBA、NRGBA 或 YCbCr 也会通过各自的 RGBA() 实现进入同一条读取路径。这个写法适合“所有图片都做同样统计”的场景。

RGBA 返回值为什么不能直接当作普通 uint8

如果最后的接口只接受 8 位通道，可以在明确不再需要更高精度时右移 8 位：

type Pixel8 struct {
    R, G, B, A uint8
}

// pixel8 将 RGBA 的 16 位通道缩放到常见的 8 位表示。
func pixel8(img image.Image, x, y int) Pixel8 {
    r, g, b, a := img.At(x, y).RGBA()
    // 右移 8 位相当于取高 8 位，适合需要 uint8 的展示或索引场景。
    return Pixel8{R: uint8(r >> 8), G: uint8(g >> 8), B: uint8(b >> 8), A: uint8(a >> 8)}
}

要注意两个边界。第一，RGBA() 的颜色分量是 alpha-premultiplied，也就是透明度较低时，RGB 分量已经按 alpha 缩放；如果要恢复“未预乘”的颜色，不能简单地把 RGB 再乘一次或直接拿它当原始通道。第二，右移会丢掉低 8 位，适合展示和粗粒度统计，不适合需要保留精度的颜色运算。

所以生产代码里可以把规则写得很明确：跨模型的通用逻辑使用 RGBA()，需要保留 16 位时保留原值，需要 8 位时统一在边界处转换；不要在多个函数里各自用不同方式截断。

需要 Gray 或 RGBA 字段时怎样转换

有些业务不是只想要四个通道，而是确实需要灰度的 Y 字段、预乘 RGBA 的结构，或者非预乘 RGBA 的四个字段。这时可以让目标模型执行转换，而不是断言 At() 返回的动态类型。

package main

import (
    "fmt"
    "image"
    "image/color"
)

// modelValues 分别取得灰度、预乘 RGBA 和非预乘 NRGBA 的稳定类型。
func modelValues(img image.Image, x, y int) {
    c := img.At(x, y)

    // Convert 会把同一个 color.Color 转成目标模型，再得到对应结构体。
    gray := color.GrayModel.Convert(c).(color.Gray)
    rgba := color.RGBAModel.Convert(c).(color.RGBA)
    nrgba := color.NRGBAModel.Convert(c).(color.NRGBA)

    // 三种结构体表达的语义不同，按业务目的选择，而不是按输入格式猜测。
    fmt.Printf("gray=%d rgba=(%d,%d,%d,%d) nrgba=(%d,%d,%d,%d)\\n",
        gray.Y, rgba.R, rgba.G, rgba.B, rgba.A,
        nrgba.R, nrgba.G, nrgba.B, nrgba.A)
}

GrayModel 适合把彩色或带透明度颜色映射为灰度；RGBAModel 得到的是 color.RGBA；NRGBAModel 用于非预乘的 color.NRGBA。这三条路径把“我需要什么语义”写在代码里，比写成 img.(*image.RGBA) 更能适应不同解码器。

遍历像素时别把左上角写死为 0

直接取单点时，坐标通常来自调用方；遍历整张图时，则必须使用 Bounds() 的最小和最大坐标。子图或经过裁剪的图像可能从非零坐标开始，固定从 0 循环会漏读或读到无效位置。

// walkPixels 遍历图像的真实边界，并把每个像素交给处理函数。
func walkPixels(img image.Image, visit func(x, y int, c color.Color)) {
    bounds := img.Bounds()
    // 使用 Min 和 Max 保留子图的坐标系，不假设原点是 (0, 0)。
    for y := bounds.Min.Y; y 

如果你的处理函数只需要颜色，不要把底层的 *image.RGBA 传出去；保留 color.Color 这个抽象，能让上层继续使用统一的 RGBA() 或目标模型转换。

我在项目里最后保留的选择规则

几个容易混淆的问题

ColorModel 能不能直接判断图片是不是 RGBA？

它是模型接口，不应该把“直接比较模型接口值”当作通用方案。要做统一处理，直接读取 At().RGBA()；要拿到某种语义明确的结构，使用对应的 color.Model.Convert。

At 返回的颜色能不能直接断言成 color.RGBA？

不能假设一定可以。At 的动态值取决于图像实现，JPEG、灰度图和自定义图像都可能返回不同颜色类型。先通过 RGBAModel.Convert 或 NRGBAModel.Convert 转换，再断言目标结构。

为什么相同的 RGB 看起来会变暗？

常见原因是把预乘 alpha 的结果当成了未预乘通道。需要独立保存颜色字段时使用 NRGBAModel，需要参与混合或沿用标准 RGBA() 语义时使用 RGBAModel。

怎样判断像素坐标是否有效？

用 img.Bounds().In(image.Point{X: x, Y: y}) 判断，或让调用方只传入这个矩形内的坐标。遍历时直接使用 Min 和 Max，不要写死图片宽高从零开始。

最终可以把代码边界收敛成一句话：ColorModel 用来理解图像的模型，At 用来取得颜色，RGBA() 用来做跨模型的统一读取，color.Model.Convert 用来得到明确的目标结构。按这个分工写，输入从 Gray 换成 RGBA 或 YCbCr 时，业务代码不需要跟着重写。

参考资料：https://pkg.go.dev/image；https://pkg.go.dev/image/color。