Go标准库无image.Resize函数，编译报undefined；缩放需用golang.org/x/image/draw或第三方imaging包，注意类型兼容、边界检查及等比策略。
Go 没有内置的 image.Resize 或 image.Crop 函数，直接写会编译失败；你看到的缩放裁剪能力，全靠组合标准库（image、image/draw）和第三方包（如 github.com/disintegration/imaging）实现。选错路径或忽略类型兼容性，轻则输出黑图、透明变灰，重则 panic。
为什么 image.Resize 会报 undefined？
Go 标准库的 image 包只定义接口和基础类型，不提供缩放逻辑。所谓“缩放”，本质是把源图用某种插值算法“画”到新尺寸的目标图像上——这由 golang.org/x/image/draw 完成。
- 别在代码里写
image.Resize(...)，它根本不存在；编译器会直接报undefined: image.Resize - 正确做法：用
draw.ApproxBiLinear.Draw(dst, dst.Bounds(), src, src.Bounds(), draw.Src) - 目标图像必须手动创建：
dst := image.NewRGBA(image.Rect(0, 0, w, h))，不能传nil或错误类型（如*image.NRGBA64） - 源图必须已成功解码，且
src.Bounds()非空；否则draw.Draw可能静默失败或 panic
用 imaging 库缩放时宽高比被破坏？
imaging.Resize(img, 300, 200, imaging.Lanczos) 是最常见误用：它强制拉伸填充，不保持原始比例。真正需要的是等比缩放策略。
- 要“缩放到指定框内不裁剪”，用
imaging.Fit：例如imaging.Resize(img, 300, 0, imaging.Fit)（宽度 300，高度自动计算） - 要“填满指定框再居中裁剪”，用
imaging.Fill：例如imaging.Resize(img, 300, 200, imaging.Fill) -
0表示该方向按比例推导，不是“不限制”——写成imaging.Resize(img, 0, 200, ...)会 panic - 别省变量赋值：必须显式写
img = imaging.Resize(...)，链式调用容易混淆中间状态
裁剪坐标总越界 panic？
imaging.Crop 和 image.SubImage 都不做边界检查。传入负数、超出原图尺寸的 x/y/w/h，运行时直接崩溃，堆栈还藏在底层像素访问里。
立即学习“go语言免费学习笔记（深入）”；
- 安全裁剪第一步：先算矩形并交集原图 bounds：
r := image.Rect(x, y, x+w, y+h).Intersect(src.Bounds()) - 居中裁 200×200？先取原图宽高：
w, h := img.Bounds().Max.X, img.Bounds().Max.Y，再算起点：x := (w - 200) / 2，y := (h - 200) / 2，最后用image.Rect(x, y, x+200, y+200) -
image.SubImage返回的是视图，不是新图；后续若修改原图或 GC 回收底层数组，裁剪结果可能异常 —— 真正需要独立副本，得用image.NewRGBA(r)+draw.Draw复制 - 用户上传图尺寸不可控，裁剪前必须加校验，尤其
x+200 这类判断
保存 JPEG 时透明区域变黑或丢信息？
JPEG 不支持 Alpha 通道，但 Go 的 jpeg.Encode 不会报错，而是静默丢弃透明层并转成 YCbCr —— 结果就是 PNG 原本的透明背景变成黑色或灰色块。
- 含透明通道的图（如 PNG）存 JPEG 前，必须合成背景色：
draw.Draw(dst, dst.Bounds(), image.NewUniform(color.White), image.Point{}, draw.Src) -
jpeg.Encode必须传*jpeg.Options，哪怕只是&jpeg.Options{Quality: 85}；传nil在部分 Go 版本会 panic - 读图时务必三值接收：
img, format, err := image.Decode(f)；只取img可能因解码器未注册而返回nil，后续操作全崩 - PNG 保存无质量参数，但可设压缩等级：
&png.Encoder{CompressionLevel: flate.BestSpeed}
顺序和类型是核心陷阱：先缩放再裁剪、先合成背景再存 JPEG、先检查 bounds 再调用 SubImage —— 这些步骤漏掉任何一环，都可能让程序在生产环境突然吐黑图或 panic，而不是报错提示你哪里错了。
