裁剪前必须校验矩形边界，否则 panic；旋转需配合正确坐标映射；jpeg 编码静默丢弃 alpha；exif 方向需显式处理；并发需限流防 oom；缩放优先降采样提升性能。
裁剪前必须校验矩形边界，否则 panic
直接用用户传入的 x、y、w、h 构造 image.Rect 是高危操作。一旦超出原图 Bounds()，调用 subImage 会触发 panic: runtime error: index out of range。
实操建议：
- 始终用
rect := image.Rect(x, y, x+w, y+h).Intersect(src.Bounds())安全截断 - 居中裁剪固定尺寸（如头像 200×200）时，先算
dx = (src.Bounds().Dx() - w) / 2，再确保dx >= 0，否则用max(0, dx) - 若需硬裁（不足则补黑边），别用
subImage，改用draw.Draw+image.NewRGBA创建目标画布
旋转不是简单交换宽高，draw.Rotate270 不等于 rotate(90)
draw.Rotate270 是 draw 包内置的仿射变换常量，但它只在 draw.Draw 的第 5 个参数中生效，且必须配合正确的源/目标坐标映射——它不改变图像数据本身，只是绘制时做旋转变换。直接对 *image.RGBA 调用它不会修改原图。
实操建议：
- 顺时针 90°：创建新画布
image.NewRGBA(image.Rect(0, 0, img.Bounds().Dy(), img.Bounds().Dx()))，再用draw.Draw(dst, dst.Bounds(), src, src.Bounds().Min, draw.Rotate270) - 任意角度（如 45°）请用
github.com/disintegration/imaging的imaging.Rotate(img, 45, color.Transparent)，自动处理插值与边缘填充 - 注意 EXIF 方向：JPEG 可能含
Orientationtag，用imaging.Decode时加imaging.AutoOrientation选项，否则旋转前已歪斜
格式转换时 alpha 通道丢失是静默行为，不是 bug
jpeg.Encode 遇到带透明通道的 *image.RGBA 会**静默丢弃 alpha** 并转成 *image.YCbCr；png.Encode 则严格要求输入类型匹配，传错会 panic。这不是库缺陷，而是 JPEG 格式本身不支持透明。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
实操建议：
- 转 JPEG 前，用
imaging.Fill或imaging.AdjustColorBalance为透明区域铺底色（如白色）：img = imaging.Fill(img, 800, 600, imaging.Center, color.White) - 转 WebP 保留透明：需启用 CGO，用
golang.org/x/image/webp，并传&webp.Options{Lossy: true, Quality: 80} - GIF 动图不能直接转 JPEG——
image/gif解码后是单帧，动图信息已丢失；要转 WebP 动图，得用专用库（如disintegration/imaging不支持）
批量处理并发数设错，内存直接爆掉
每张图解码后至少占用 width × height × 4 字节（RGBA），100 张 4000×3000 图未限制并发就开 goroutine，轻松吃光 4GB 内存。Go GC 来不及回收，进程被 OOM killer 干掉。
实操建议：
- 用带缓冲 channel 控制 worker 数量：
sem := make(chan struct{}, 4)，每个 goroutine 开始前sem ，结束时 <code> - 避免在闭包里捕获循环变量：
for _, path := range files { go func(p string) { process(p) }(path) }，别写成go func() { process(path) }() - 大图优先降采样：对边长 > 5000px 的图，先用
imaging.Resize(img, 0, 2000, imaging.Lanczos)缩小再处理，比原图操作快 3–5 倍且内存友好
真正麻烦的不是 API 调用，是那些不报错却悄悄改掉你图像的行为——比如 JPEG 编码丢 alpha、EXIF 旋转没处理、并发没限流。这些点不手动踩一遍，很难信。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
