Go image.NRGBA 写入半透明像素后颜色为什么变了

image.NRGBA 保存的是非预乘的8位 R、G、B、A。写入半透明像素后“颜色变了”，应先区分两件事：传给 Set 的颜色是否属于预乘模型，以及读取时是否调用了 RGBA()。后者按 color.Color 的约定返回16位范围的预乘值，不能直接与原始8位 RGB 字段比较。

如果手里的 RGB 是未乘透明度的原始颜色，用 color.NRGBA 写入，并用 NRGBAAt 读取字段。若误用 color.RGBA，即使四个数字一样，输入的颜色含义也已经不同。本文只解释这层语义和 Set 的结果，不讨论缩放与编码质量。

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

先区分原始颜色与 RGBA 方法返回值

一个常见的排查场景是：程序写入 RGB 和 A，再从 At 得到颜色并调用 RGBA，发现数值不再是原来的80、40、20，于是以为目标图像修改了颜色。此时先看比较的是否是同一种表示，而不是立刻调整像素值“补偿”。

color.Color 的 RGBA 方法返回值类型虽然是 uint32，数值范围却是0到65535；RGB 已经乘上 Alpha。NRGBA 的字段则是0到255的非预乘值。透明度低于完全不透明时，两种表示不仅范围不同，还多了一次透明度因子。

可以用概念关系理解：先把8位通道扩展到16位范围，再按 A/255 预乘。实际实现使用整数运算，会有舍入与截断。若把接口的 r 右移八位，只是缩小数值范围，并没有把预乘语义自动还原成非预乘 RGB。

Set 写入时，输入类型决定颜色的解释

Set 接收的是 color.Color。目标虽然是 NRGBA，输入仍由自身类型定义颜色含义；目标会通过颜色模型转换后保存。color.NRGBA 的 RGB 不预乘，color.RGBA 的 RGB 已预乘，这不是两组字段名相同就能互换的结构。

例如 R=80、A=128：放在 NRGBA 里表示原始红色分量80、透明度约一半；放在 RGBA 里，80已经表示乘过透明度后的分量。转成 NRGBA 时需要解除预乘，保存的红色字段就会变大。这是对另一种输入含义的转换，不是随机改色。

有效的预乘 RGBA 通道不应超过 A。若用 R=255、A=128 这样的组合假装表达半透明纯红，就已经违反预乘颜色的约定，不应以它为基础推导通用转换规律。本文的对照输入选择各 RGB 均不大于 A，先排除无效输入干扰。

用同一像素对照 Set 与 SetNRGBA

下面的原创完整程序仅创建内存图像并输出字段文本，不生成示例图、不编码文件。三个像素分别使用 SetNRGBA、传入 NRGBA 的 Set，以及传入 RGBA 的 Set，便于把存储和接口表示分别观察。

package main

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

func main() {
    img := image.NewNRGBA(image.Rect(0, 0, 3, 1))
    straight := color.NRGBA{R: 80, G: 40, B: 20, A: 128}
    // 两种写法都明确使用非预乘分量。
    img.SetNRGBA(0, 0, straight)
    img.Set(1, 0, straight)

    // 字面数字相同，但 RGBA 表达预乘颜色，是另一种输入含义。
    img.Set(2, 0, color.RGBA{R: 80, G: 40, B: 20, A: 128})

    for x := 0; x 

按接口和实现语义，前两个像素的 NRGBA 字段应保持为80、40、20、128；第三个会把预乘输入转换成非预乘字段，不能期待与前两个相等。三个像素调用 RGBA 后得到的又是预乘表示，不能把这组结果直接称为图像内部的四个字节。

这是语义推导的预期说明，本文没有运行程序或展示实测截图。排查自己代码时，最有帮助的记录是“输入具体类型、目标具体类型、读取方式”三者同时保留，而不是只打印四个没有模型标签的数字。

SetNRGBA 的参数类型已经固定为 color.NRGBA，适合输入确实为非预乘8位分量的情况。它不会替调用方判断数据是否已经预乘；如果把预乘数据重新装进 NRGBA 结构体，类型虽然通过了编译，含义仍然错误。

读取原始分量时选择 NRGBAAt

目标确定为 *image.NRGBA 时，读取原始8位字段用 NRGBAAt 更直接。At 返回的是 color.Color 接口，并不意味着它必须用 RGBA 方法才能读；但调用接口的 RGBA 以后，就已进入通用预乘表示。

// 已知目标类型是 *image.NRGBA，读取字段时直接使用 NRGBAAt。
c := img.NRGBAAt(x, y)
red, green, blue, alpha := c.R, c.G, c.B, c.A
// 修改透明度时保留非预乘 RGB，不手工再乘一次 alpha。
img.SetNRGBA(x, y, color.NRGBA{R: red, G: green, B: blue, A: alpha / 2})

上面的局部片段沿用已有 img、x、y 及导入。它表达的是在非预乘模型里调整透明度：RGB 字段保持，A 减半。若先手工把 RGB 再乘以 A，然后仍用 NRGBA 写入，之后展示时透明度还会参与颜色解释，容易造成重复变暗。

直接读写 Pix 也必须遵守图像的 Rect、Stride 与 PixOffset，不要假定每一张图都从坐标零开始或每行字节数恰好等于宽度乘四。本文建议先用类型方法排查语义，避免把颜色模型问题与缓冲区索引问题混在一起。

还要确认坐标在 Bounds 内。越界 Set 不会完成预期写入，越界 NRGBAAt 返回零值；把这个零值解释成透明度转换导致颜色丢失，会让排查方向完全偏离。

透明边界与预乘转换会丢失什么

A=255 时，两种模型之间的差别容易被完全不透明样本掩盖；只用这种输入，很难暴露错误。半透明样本应作为独立情形理解，同时检查透明度非常低和为零时的信息边界。

A=0 时，非预乘结构体可以保留非零 RGB 字段，但 RGBA 接口中的预乘 RGB 为零。只剩下这份预乘结果后，无法再推断原来隐藏的 RGB 是什么。解除预乘不可能恢复已经丢掉的信息。

同样，反复进行预乘、解除预乘和8位量化，不能保证每次都逐字节回到起点。对于要保留原始非预乘字段的数据路径，应尽量保持 NRGBA 的表示，不要为了统一调用接口而来回转换。

这并不等于屏幕显示会直接呈现字段的颜色。半透明像素叠在不同背景上会形成不同的视觉结果。本文聚焦字段与接口值，不用图像显示效果反过来证明某个数值转换是否正确。

按数据含义整理像素处理接口

整理像素处理接口时，建议在变量和函数参数旁写明“预乘或非预乘、8位或16位”。完成数据处理后，普通图像对象不需要 Close；如果另有文件等资源，应由相应读写层负责。不要为消除数值差异而在结束阶段随意清零 RGB，那会改变要保存的数据。

Set 传入 color.NRGBA 也会改变这些字段吗？

对有效坐标和当前 NRGBA 模型路径，输入 NRGBA 会按其字段保存。若读回不同，先查读取方式、坐标和是否有后续修改，不应先归因于透明度。

RGBA() 的返回类型是 uint32，为什么只说16位范围？

返回类型提供运算空间，接口契约规定的分量范围仍是0到65535。不能把类型位宽与通道数值范围当作同一件事。

颜色看起来变暗就一定是 Set 写错了吗？

不一定。先比较 NRGBAAt 的字段是否与预期一致，再看调用者是否把预乘值当成原始 RGB，以及展示背景如何参与透明合成。

参考：image.NRGBA 官方接口、color.Color 与颜色模型约定、NRGBA 读写实现、颜色模型转换实现。示例与排查场景为本文原创。