Go image.NewRGBA 怎样创建可修改的 RGBA 画布

如果目标是得到一块可以逐像素修改的 Go 图像，直接使用 image.NewRGBA(image.Rect(0, 0, width, height))。它返回 *image.RGBA，画布范围由矩形决定，常规写入优先使用 SetRGBA；只有需要批量处理底层字节时，才进一步理解 PixOffset 和 Stride。

核心判断：NewRGBA 负责创建带 RGBA 颜色模型的内存图像，不负责替你定义坐标边界。先核对 Bounds()，再写像素；不要把切片长度当成坐标范围。

先定义画布：Rectangle 决定可写坐标

image.NewRGBA 接收一个 image.Rectangle。下面的例子创建 320×180 的画布，并用 Bounds 把边界留在对象旁边，后续绘制代码只在这个范围内工作。

package main

import (
	"image"
	"image/color"
)

func newCanvas() *image.RGBA {
	// Rect 的右下角不包含在范围内，因此宽高分别是 320 和 180。
	canvas := image.NewRGBA(image.Rect(0, 0, 320, 180))
	// 用一个明确的颜色写入画布左上角，验证写入入口是 SetRGBA。
	canvas.SetRGBA(0, 0, color.RGBA{R: 30, G: 120, B: 220, A: 255})
	return canvas
}

这里的 Rect(0, 0, 320, 180) 表示 x 的有效范围是 0 到 319，y 的有效范围是 0 到 179。SetRGBA 直接接受四个 8 位通道，适合大多数绘制和单点修改场景。

用 SetRGBA 写像素，不要先手算下标

当任务是画点、填充矩形或修改少量像素时，SetRGBA 能把颜色写入细节藏在类型方法后面。循环的边界应该取自 Bounds，这样画布采用非零原点时也不会误把 0 当成起点。

func fillBand(dst *image.RGBA, y0, y1 int, c color.RGBA) {
	b := dst.Bounds()
	// 将调用方的纵向范围裁到画布内，避免写入无效坐标。
	if y0  b.Max.Y {
		y1 = b.Max.Y
	}
	for y := y0; y 

要注意 Max 是排他的上界，所以循环条件使用 。如果只是把一个已有颜色填进整行，仍可以先用这种清楚的写法；只有性能确实要求连续写入时，再下沉到字节切片。

需要批量写入时：看懂 Pix 与 Stride

image.RGBA 的每个像素按 R、G、B、A 四个字节保存。Pix 是底层切片，Stride 是相邻两行在切片中的字节距离。不要把 Stride 简单理解为“图片宽度”：它是按字节计算的行跨度。

func paintFirstRow(dst *image.RGBA, c color.RGBA) {
	b := dst.Bounds()
	if b.Empty() {
		return
	}
	// PixOffset 会把非零原点换算成 Pix 中的起始偏移。
	offset := dst.PixOffset(b.Min.X, b.Min.Y)
	// 每个 RGBA 像素占 4 字节；只处理第一行的可见像素。
	for x := b.Min.X; x 

手动写 Pix 时必须同时维护坐标、每像素字节数和行边界；跨行写入还要把行号乘以 Stride。因此，普通业务代码使用 SetRGBA 更稳，底层批处理则应把 PixOffset、Stride 和 Bounds 一起看。

非零原点与 SubImage 的两个边界

通过 image.Rect(10, 20, 110, 80) 创建画布时，合法坐标从 (10,20) 开始，而不是从 (0,0) 开始。调用 SetRGBA(0, 0, ...) 并不会因为“切片里有位置”就变成有效绘制；调用方应先使用 Bounds().Min 和 Bounds().Max。

SubImage 返回原图的一部分视图，并与原图共享像素。修改子图可能影响原图对应区域，所以它适合避免复制的局部处理，也要求调用方明确谁拥有这块可写内存。若需要独立副本，应创建新的 RGBA 再复制像素。

常见问题

为什么创建后画面是透明的？ 新分配的 RGBA 字节默认是零值，Alpha 为 0。要得到不透明背景，先用 Alpha 为 255 的颜色填充。

什么时候应该直接改 Pix？ 只有在连续像素批处理、编码适配或性能路径已明确时。单点绘制优先用 SetRGBA，可读性和坐标边界更容易维护。

总结一下：NewRGBA 先把 Rectangle 变成可修改画布；SetRGBA 负责清楚地写像素；进入底层批处理时，再同时理解 PixOffset、Stride、非零原点和 SubImage 的共享关系。