go中保存图片需先有非空image.image实例，用png.encode或jpeg.encode写入文件；创建rgba画布时须确保坐标不越界且图像尺寸有效。
用 image/png 或 image/jpeg 直接编码到文件
Go 标准库不提供“画布”抽象，但如果你已有 image.Image 接口值（比如 *image.RGBA），写入图片文件就是调用对应格式的 Encode 函数。关键不是“画布”，而是你手头的 image.Image 实例是否已构造好。
常见错误是传入 nil 图像或未初始化的像素数据，导致 Encode 返回 invalid image: image is nil 或写入空白/损坏文件。
- 确保图像数据非空：检查
img.Bounds().Max.X > 0 && img.Bounds().Max.Y > 0 - 写 PNG 用
png.Encode，写 JPEG 用jpeg.Encode（JPEG 不支持透明通道，*image.RGBA的 alpha 值会被丢弃） - 文件需以写模式打开：
f, err := os.Create("out.png")，别用os.OpenFile忘加os.O_CREATE|os.O_WRONLY - JPEG 编码可传
*jpeg.Options控制质量，例如&jpeg.Options{Quality: 90}
f, _ := os.Create("output.png")
defer f.Close()
png.Encode(f, img) // img 是 *image.RGBA 或其他 image.Image 实现
从零创建 RGBA 画布并填充像素
很多场景下你其实没有现成图像，只是想“画点东西”再保存——这时得手动创建 *image.RGBA，设置像素，再编码。
容易踩的坑是坐标越界：RGBA 的 Set(x, y, color.Color) 要求 x 且 <code>y ，否则静默失败（像素不生效）。
- 创建时用
image.Rect(0, 0, w, h)明确指定尺寸，别依赖默认零值 -
color.RGBA{255,0,0,255}是纯红（alpha=255 表示不透明），注意 Go 的 RGBA 是 8 位分量，取值 0–255 - 循环写像素时，外层是
y，内层是x，符合图像坐标系习惯（避免把宽高颠倒）
bounds := image.Rect(0, 0, 100, 100) img := image.NewRGBA(bounds) for y := bounds.Min.Y; y <h3>写入 WebP 或其他格式需要第三方库</h3> <p>标准库只支持 PNG、JPEG、GIF、BMP 和一些小众格式（如 PPM）。WebP、TIFF、HEIC 等必须用外部包，比如 <code>golang.org/x/image/webp</code>。</p> <p>典型问题是直接 import 了包却没调用注册函数，导致 <code>image.Decode</code> 可用但 <code>image.Encode</code> 报错 <code>unknown format</code> ——因为编码器没注册。</p>
- WebP 编码需先
import _ "golang.org/x/image/webp"（下划线导入触发 init） - 然后用
webp.Encode替代png.Encode，它接受*webp.Options控制质量与有无动画 - 注意：x/image 下的包大多不维护向后兼容，Go 1.22+ 中部分 API 已变，建议锁死
go.mod版本
内存数据来自 bytes.Buffer 时别漏掉 .Bytes()
有人会先把图像编码到 bytes.Buffer，再写文件，结果文件内容为空——因为忘了从 buffer 读出字节。
buf.WriteTo(f) 可以直接写，但更常见的是误用 f.Write(buf.String())（String() 对二进制图像是错的）或 f.Write(buf.Bytes()) 后没清 buffer，导致下次复用时写入重复内容。
- 编码到 buffer：用
png.Encode(&buf, img) - 写文件：用
f.Write(buf.Bytes())或io.Copy(f, &buf) - 若需复用 buffer，记得
buf.Reset()，否则Bytes()返回历史累计数据
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
