Go image/color.RGBA 为什么读取到的 RGB 已经乘过 Alpha

Go 图像代码里看到 color.RGBA{R: 255, G: 80, B: 40, A: 64}，再调用 RGBA() 却发现 RGB 变小，通常不是 PNG 解码错了，而是你读到的是预乘 Alpha 的表示。color.RGBA 的 RGBA() 会把颜色通道按 Alpha 缩放后返回，返回范围还是 16 位通道，而不是原结构体里的 8 位字段。

如果业务要理解“实际参与合成的颜色”，使用 RGBA() 是正确的；如果业务要保留图片里未乘 Alpha 的原始 RGB，就要使用 color.NRGBA，或者通过 color.NRGBAModel.Convert 明确转换。

官方地址：https://pkg.go.dev/image/color

下面只围绕颜色模型和读取方式排查，不把它扩展成图像滤镜、色彩空间或编码器教程。

先区分 RGBA 结构体和 RGBA() 返回值

color.RGBA 是一个包含四个 8 位字段的颜色类型，但它实现的 RGBA() 方法返回四个 uint32。这四个返回值的范围是 0 到 65535，并且 R、G、B 已经按照 Alpha 做了预乘。

例如 Alpha 是 64/255 时，原始的红色通道不会继续以 255 的强度返回，而会变成大约 255 × 64 / 255 对应的 16 位结果。这里的“变小”是颜色表示的约定，不代表图像数据被随机修改。

package main

import (
    "fmt"
    "image/color"
)

func main() {
    c := color.RGBA{R: 255, G: 80, B: 40, A: 64}

    // RGBA() 返回的是预乘 Alpha 后的 16 位通道，不是结构体字段的原样复制。
    r, g, b, a := c.RGBA()
    fmt.Printf("r=%d g=%d b=%d a=%d\\n", r, g, b, a)
}

排查时先看调用点：如果代码调用的是 c.RGBA()，就必须按预乘语义解释；如果只是读取 c.R、c.G、c.B，那仍然是结构体保存的 8 位字段。两者解决的是不同问题。

为什么透明度越低，读取到的 RGB 越小

预乘 Alpha 的目标是让颜色直接参与透明合成。对一个颜色通道来说，预乘后的值可以理解为“颜色强度 × 不透明度”。当 Alpha 接近 0 时，RGB 也会接近 0；当 Alpha 为满不透明时，RGB 才能保持原来的最大强度。

这也解释了一个常见误判：把 RGBA() 返回的 16 位值右移 8 位后，与某个 PNG 像素的原始 RGB 字段比较。如果像素不是完全不透明，两边本来就不是同一种表示，直接比较必然会觉得颜色变暗。

需要原始 RGB 时怎样使用 NRGBA

如果代码确实要保存“透明度之外的原始 RGB”，优先使用 color.NRGBA。它的字段表达的是非预乘颜色，透明像素仍可以保留较高的 RGB 数值，适合做颜色采样、导出前的通道处理或需要区分底色的场景。

package main

import (
    "fmt"
    "image/color"
)

func main() {
    c := color.NRGBA{R: 255, G: 80, B: 40, A: 64}

    // NRGBA 字段是非预乘表示，直接读取字段即可保留原始 8 位 RGB。
    fmt.Printf("r=%d g=%d b=%d a=%d\\n", c.R, c.G, c.B, c.A)

    // 调用 RGBA() 仍会按 color.Color 接口约定返回预乘后的 16 位通道。
    r, g, b, a := c.RGBA()
    fmt.Printf("premultiplied=%d,%d,%d,%d\\n", r, g, b, a)
}

注意：即使变量的静态类型是 color.NRGBA，一旦调用它的 RGBA() 方法，得到的仍然是接口统一的预乘形式。想要非预乘值，就读 NRGBA 的字段，不能用 RGBA() 的结果倒推原值。

只有 image.Image 时怎样显式转换

实际函数通常拿到的是 image.Image，通过 At(x, y) 返回一个 color.Color 接口。此时不能假设底层一定是 color.RGBA 或 color.NRGBA，更不能直接做不安全的类型断言。

可以使用 color.NRGBAModel.Convert 把任意 color.Color 转成非预乘的 color.NRGBA。转换会遵循颜色模型规则，比手工用整数乘除更清晰。

package main

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

func sample(img image.Image, x, y int) (color.NRGBA, error) {
    if img == nil {
        return color.NRGBA{}, fmt.Errorf("image is nil")
    }
    if !image.Pt(x, y).In(img.Bounds()) {
        return color.NRGBA{}, fmt.Errorf("point (%d,%d) is outside image bounds", x, y)
    }

    // At 返回接口颜色，使用 NRGBAModel 统一转换为非预乘 8 位颜色。
    converted := color.NRGBAModel.Convert(img.At(x, y))
    nrgba, ok := converted.(color.NRGBA)
    if !ok {
        return color.NRGBA{}, fmt.Errorf("unexpected converted color type %T", converted)
    }
    return nrgba, nil
}

这里的边界判断还有两个作用：避免访问图像矩形之外的坐标，也提醒读者 image.Rectangle 通常采用左闭右开范围。若采样坐标来自用户输入，先检查 Bounds() 再调用 At，比把越界问题混在颜色转换问题里更容易排查。

用检查清单定位颜色变暗问题

遇到“读取后 RGB 变小”时，可以按下面的顺序确认：

1. 确认调用的是字段读取还是 RGBA()；二者不是同一种表示。
2. 记录 Alpha 值；Alpha 越低，预乘后的 RGB 越低是预期行为。
3. 确认返回值是否被从 16 位错误截断为 8 位，例如不要直接把低 8 位当成高 8 位。
4. 需要原始 RGB 时使用 NRGBA 字段或 NRGBAModel.Convert，不要从预乘结果反推。
5. 比较两个颜色前先统一模型，否则“颜色不一致”可能只是表示不一致。

一句话总结：RGBA() 是 color.Color 的统一接口，它优先服务于合成语义；NRGBA 负责保留非预乘通道。先确定业务要的是合成颜色还是原始颜色，再选择读取方式。

常见问题

color.RGBA{255, 0, 0, 0} 调用 RGBA() 后为什么 RGB 也接近 0？ 因为它按预乘 Alpha 规则返回，完全透明时颜色通道不参与合成。

把 RGBA() 返回值右移 8 位就能恢复原始 RGB 吗？ 不能。右移只能做位宽缩放，不能撤销 Alpha 预乘；要保留原始通道，应使用非预乘颜色类型或在转换前保存原值。

image.Image.At 返回的颜色一定是 color.RGBA 吗？ 不一定。它返回 color.Color 接口，具体实现取决于图像类型，通用代码应使用颜色模型转换而不是假设具体类型。