Go标准库image/png仅负责PNG编解码，不处理绘制；Decode需io.Reader输入并返回适配原始色深的image.Image（如NRGBA/Gray），Encode要求图像实现ColorModel/Bounds且格式合法；常见错误包括忽略错误、越界访问、签名缺失等。
image/png 包是 Go 标准库中处理 PNG 图片的核心工具，它不负责图像绘制或像素操作，只做编码（Encode）和解码（Decode）——也就是说，你得先有 image.Image 实例才能用它存成 PNG，也得靠它把 PNG 数据读成 image.Image。
如何从文件读取 PNG 并解码为 image.Image
直接调用 png.Decode 即可，但注意它需要一个实现了 io.Reader 的输入源，比如 *os.File 或 bytes.Reader。常见错误是忽略返回的 color.Model（通常可忽略），或没检查错误导致 panic。
示例：
file, _ := os.Open("input.png")
defer file.Close()
img, err := png.Decode(file)
if err != nil {
log.Fatal(err) // 不要忽略 err
}
// img 是 *image.NRGBA、*image.RGBA 等具体类型，取决于原始 PNG
- 如果 PNG 带 alpha 通道，
png.Decode通常返回*image.NRGBA；纯灰度图可能返回*image.Gray - 不要对
img.Bounds()外的坐标调用At()，Go 不做边界检查，会静默返回黑点 - 某些带特殊色域或 ICC profile 的 PNG 可能被标准
png.Decode拒绝（报invalid format: invalid header或类似），这时需用第三方库如disintegration/imaging
如何将 image.Image 编码为 PNG 并写入文件
用 png.Encode，它接受 io.Writer 和 image.Image。关键点在于：不是所有 image.Image 都能被直接编码 —— png.Encode 要求图像类型必须实现 ColorModel() 和 Bounds()，且像素数据格式需在 PNG 支持范围内（如 image.NRGBA、image.RGBA、image.Gray 等）。
立即学习“go语言免费学习笔记（深入）”；
示例：
out, _ := os.Create("output.png")
defer out.Close()
err := png.Encode(out, img)
if err != nil {
log.Fatal(err)
}
- 若传入自定义结构体实现
image.Image但未正确实现At()或ColorModel()，png.Encode会 panic 或写入损坏文件 - 编码过程不压缩，但 Go 的
png.Encode默认使用 zlib 的默认压缩级别（约 6），无法调整；如需控制压缩率，得自己封装zlib.Writer+ 手动构造 PNG 结构（极少见） - 写入网络连接或 HTTP 响应体时，务必确保
Writer支持多次小块写入，否则可能卡住或截断
为什么 Decode 后的图像类型不总是 *image.RGBA
Go 的 png.Decode 尽量保持原始 PNG 的颜色空间和位深，以减少精度损失和内存占用。它根据 IHDR chunk 中的 color type 和 bit depth 字段决定返回类型：
- color type 0（灰度）+ bit depth 8 →
*image.Gray - color type 2（RGB）+ bit depth 8 →
*image.RGBA（但注意：PNG RGB 没 alpha，Go 会补全 alpha=255） - color type 6（RGBA）+ bit depth 8 →
*image.NRGBA（premultiplied alpha） - bit depth 16 的 PNG 会被降采样为 8 位（除非你自己实现
image.Image并用binary.Read解析原始数据）
如果你后续要做像素级修改（比如改某个点的颜色），建议统一转成 *image.NRGBA：
bounds := img.Bounds() rgba := image.NewNRGBA(bounds) draw.Draw(rgba, bounds, img, bounds.Min, draw.Src)
常见错误：invalid format: not a PNG file
这个错误不是 PNG 内容损坏，而是文件开头没有正确的 PNG signature（\x89PNG\r\n\x1a\n）。常见原因：
- 文件被文本编辑器意外打开并保存过（加了 BOM 或换行）
- HTTP 响应体里混入了调试日志、空格或重定向响应头
- 用
os.Open打开的是目录而非文件（os.IsNotExist检查不等于“是 PNG”） - 读取时用了
bufio.Scanner（会丢弃首字节）或io.CopyN截断了前 8 字节
验证是否真为 PNG：用 hexdump -C file.png | head -n1 看前 8 字节是否匹配。修复方法是确保输入流从第一个字节开始、未被篡改。
真正麻烦的不是编解码本身，而是图像类型转换、alpha 处理、边界检查这些隐式行为 —— 它们不会报错，但会让图片变黑、偏色或内存暴涨。动手前先 fmt.Printf("%T", img) 看清类型，比盲目调用 At() 安全得多。
