Go draw.Draw 使用遮罩后边缘颜色为什么变淡

用 image/draw 做带软边的圆形、文字或透明贴图时，常见现象是主体颜色正常，遮罩边缘却像被“洗淡”了。原因通常不是 draw.DrawMask 改了颜色，而是边缘遮罩的 alpha 小于 255，配合 draw.Over 后，源图只以一部分强度覆盖目标底图。要保留底图就接受这种混合；要完全替换目标内容则考虑 draw.Src，同时还要确认 RGBA 颜色是否按预乘语义提供。

从 Draw 到 DrawMask，先把三个坐标对齐

draw.Draw 实际上调用的是带 nil mask 的 DrawMask，因此它不会产生遮罩边缘。需要遮罩时，目标矩形 r 的左上角分别对应源图中的 sp 和遮罩中的 mp。只要其中一个点偏移，读到的就可能是半透明边缘，看起来也像颜色变淡。

先检查三件事：r.Dx() 与源图、遮罩的有效区域是否重叠；sp 是否指向源图期望的起点；mp 是否指向遮罩中同一位置。标准库还会把目标矩形裁剪到三者 bounds 的交集，越界部分不会“补成不透明”。

为什么遮罩边缘会变淡：alpha 已经参与 Over 合成

可以把每个像素理解为 dst = (src IN mask) Over dst。中心的遮罩 alpha 接近 255，源图几乎完整覆盖；边缘 alpha 只有一部分，源图的颜色和透明度都会被削弱，剩余区域由目标底图补上。因此在白色或浅色背景上，深色边缘尤其容易显得发灰、发白。

draw.Over 的职责是“源图覆盖到目标上”，不是把源图强行变成不透明色。即使源图本身完全不透明，只要 mask 的 alpha 是 128，边缘仍然是半透明贡献。若你把遮罩做成硬边，颜色会变实，但抗锯齿也会消失。

Over、Src 和 RGBA/NRGBA 怎么选

先按目标效果选算子，再处理颜色模型。下面这段最小写法保留底图；将最后一个参数改成 draw.Src，则目标矩形中写入的是经过 mask 的源图结果，不再把原目标颜色作为 Over 的底层参与者。

package main

import (
    "image"
    "image/color"
    "image/draw"
)

func composite(dst, src image.Image, mask image.Image) *image.RGBA {
    // 目标必须可写；先把底图转换到统一的 RGBA 画布。
    out := image.NewRGBA(image.Rect(0, 0, 320, 200))
    draw.Draw(out, out.Bounds(), image.NewUniform(color.RGBA{R: 24, G: 30, B: 42, A: 255}), image.Point{}, draw.Src)

    // r、sp、mp 的左上角分别对齐目标、源图和遮罩的对应像素。
    r := image.Rect(20, 20, 20+src.Bounds().Dx(), 20+src.Bounds().Dy())
    draw.DrawMask(out, r, src, src.Bounds().Min, mask, mask.Bounds().Min, draw.Over)
    return out
}

这里的 draw.Src 只用于初始化纯色画布，真正的遮罩合成使用 draw.Over。如果要覆盖一个区域，换成 draw.Src 只能改变“是否读取底图”，不能把 mask 的半透明边缘自动变成实色。

颜色模型也要分清：color.RGBA 的 RGB 分量按 alpha 预乘，color.NRGBA 的 RGB 分量不预乘。给半透明颜色手工赋值时，若实际数据是非预乘的，却声明成 RGBA，转换与合成就可能出现额外的暗边或亮边。标准库对常见 NRGBA 路径有专门处理，但调用方仍应让图像类型和数据来源一致。

用固定背景和像素抽样确认是哪一层在变

排查时不要只看最终图片。把目标初始化为固定深色，分别抽取中心、软边和遮罩外部三个像素，记录 mask alpha、源图 alpha 和输出 RGBA。中心正常、软边随背景变化，说明是预期的 Over 混合；所有位置都偏色，优先检查 RGBA/NRGBA；整块错位，则回到 r、sp、mp 的坐标。

最终的迁移清单很短：保留底图用 Over，覆盖目标用 Src；软边需要渐变就保留半透明 mask；源图来自 PNG 或手工像素时先确认颜色模型；发布前用固定背景抽样，而不是凭肉眼猜测。

常见问题

把 draw.Over 改成 draw.Src 就能修复淡边吗？

不一定。它只是不再使用目标原内容做 Over 底图，mask alpha 仍会限制写入强度；淡边的根因若是软遮罩，仍然存在。

为什么换成白色背景后边缘更明显？

半透明边缘会把源图颜色与背景混合，浅色背景会提高输出亮度并降低边缘饱和度，所以视觉上更像被洗白。

什么时候应该使用 NRGBA？

当数据以未预乘 RGB 加 alpha 的形式保存或处理时，使用 NRGBA 更符合字段含义；跨类型合成前仍应让整个管线的颜色模型保持明确一致。