Go image/draw.DrawMask 怎么按透明蒙版合成图片

用 Go 按透明蒙版合成图片，关键调用就是 draw.DrawMask：把要放入的源图传给 src，把控制透明度的 Alpha 图传给 mask，再用 draw.Over 叠加到 dst。最容易出错的地方不是函数名，而是 r.Min、sp、mp 没有对齐，或者误用 draw.Src 把背景覆盖掉。

一、先把 DrawMask 的三组坐标对齐

DrawMask(dst, r, src, sp, mask, mp, op) 中，r 是目标图上要写入的矩形。函数会把 r.Min 分别和目标区域、源图的 sp、蒙版的 mp 对齐。也就是说，r 的宽高决定取多少内容，三个起点决定从哪里取。

二、用 Alpha 图表达透明蒙版

蒙版本质上也是 image.Image。用 image.NewAlpha 创建时，每个像素的 uint8 值就是透明度控制量：0 表示不让源图参与，255 表示完全允许，中间值表示半透明。蒙版的颜色通道不重要，重要的是 Alpha。

package main

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

func main() {
	dst := image.NewRGBA(image.Rect(0, 0, 480, 320))
	// 先铺一层可见背景，方便观察蒙版带来的透明效果。
	draw.Draw(dst, dst.Bounds(), image.NewUniform(color.RGBA{R: 32, G: 42, B: 58, A: 255}), image.Point{}, draw.Src)

	src := image.NewRGBA(image.Rect(0, 0, 240, 160))
	mask := image.NewAlpha(src.Bounds())
	for y := 0; y 

示例使用人工创建的颜色块，只为了说明坐标和 Alpha 关系。接入 PNG 等真实输入时，先分别解码为 image.Image，再按相同方式传入；不要把蒙版的尺寸误当成目标矩形尺寸。

三、用 draw.Over 保留背景并叠加源图

draw.Over 表示“源图按蒙版限制后覆盖到目标图上”。因此上例中，左边低 Alpha 区域仍能看到深色背景，右边高 Alpha 区域更接近青绿色源图。如果把操作改成 draw.Src，它会把目标区域替换为组合后的源结果，透明部分也可能表现为目标区域被清空，适合明确的替换而不是普通叠加。

如果蒙版传入 nil，标准库会把它当作不透明蒙版处理，这相当于不使用额外的透明限制。这个行为适合复用同一套绘制代码，但不适合拿来代替真正的 Alpha 蒙版。

四、结果不对时按这张清单排查

1. 整块位置偏移：检查 r.Min.Add(sp) 和 r.Min.Add(mp) 是否对应同一个内容起点；源图或蒙版有非零 Bounds().Min 时，不要想当然地传 image.Point{}。
2. 蒙版完全没有效果：确认传入的是带 Alpha 的图像，并检查 Alpha 是否全部为 255；灰度图不等于透明蒙版。
3. 背景突然消失：确认是否使用了 draw.Src；需要保留已有背景时改用 draw.Over。
4. 边缘出现异常：让 r、源图采样区域和蒙版采样区域保持同样宽高，先从整数对齐的矩形开始定位。

常见问题

DrawMask 的 mask 必须是 image.Alpha 吗？

不必须。它只需要实现 image.Image，标准库会读取颜色的 Alpha；但用 image.NewAlpha 表达意图最清楚，也最容易逐像素设置透明度。

什么时候可以直接用 draw.Draw？

不需要蒙版时用 draw.Draw 即可，它相当于调用带 nil mask 的 DrawMask。需要局部透明控制时才使用 DrawMask。

如何判断是坐标问题还是 Alpha 问题？

先把 mask 临时换成同尺寸、全 Alpha 为 255 的蒙版；如果位置正确，问题就在 Alpha 值或蒙版采样起点，否则继续检查 r、sp 和 mp。