image.Decode报“unknown format”或panic，根本原因是Go标准库默认只注册PNG解码器，JPEG/GIF/WebP需显式导入对应包（如_import _ "image/jpeg"_）以触发RegisterFormat；上传时不可信Content-Type，须用http.DetectContentType或DecodeConfig校验文件头；大图解码易OOM，应先DecodeConfig获取尺寸再按需处理，并统一用*image.NRGBA保障Alpha通道兼容。
直接用 image.Decode 处理用户上传图，不加限制和校验，90% 会在线上 OOM 或 panic；真正能扛住并发、支持 JPG/PNG/GIF/WebP 的裁剪+水印模块，核心不在“写多少行”，而在三处必须绕开的坑：解码器注册、内存控制、颜色空间对齐。
为什么 image.Decode 总报 “unknown format” 或 panic
Go 标准库不会自动识别格式，哪怕文件后缀是 .jpg，内容是 GIF，image.Decode 也会失败——不是文件坏，是没注册解码器。
- 必须显式导入：
import _ "image/jpeg"、import _ "image/png"、import _ "image/gif"（WebP 需额外引入golang.org/x/image/webp） - 别只 import
"image"，它不带任何解码逻辑 - 上传时别信
Content-Type，先用http.DetectContentType或读前 512 字节调image.DecodeConfig确认真实格式 - 动图（GIF）默认不支持 interlaced，真要处理得换第三方库，标准库只保基础帧
裁剪大图时内存爆掉的真正原因和对策
一张 4000×3000 的 JPG，解码后内存占用 ≈ width × height × 4 字节 = 48MB；10 并发就是近 500MB，还没开始裁剪。
- 永远别在 handler 里直接调
image.Decode—— 先用jpeg.DecodeConfig或png.DecodeConfig拿尺寸，再决定是否流式裁剪 - 对 >5MB 的上传体，用
http.MaxBytesReader包裹req.Body，硬限 10MB 上限 - 裁剪参数必须校验：
left、top、width、height全 ≥ 0，且left+width ≤ orig.Bounds().Max.X，否则image.Rect构造直接 panic - 安全裁剪写法：
rect := image.Rect(x, y, x+w, y+h).Intersect(src.Bounds())，自动截断越界部分
水印糊、偏色、透明失效的底层根源
不是代码写错，是 color.Model 不一致导致 draw.Draw 静默转错：JPG 默认是 color.YCbCr，PNG 是 color.NRGBA，叠加时 alpha 通道被丢或溢出。
立即学习“go语言免费学习笔记（深入）”；
- 统一用
image.NewNRGBA创建目标图，它原生支持 alpha 且兼容所有draw操作 - 水印图也必须是
*image.NRGBA类型，加载后用imaging.Clone或手动转换，别依赖隐式类型推导 - 文字水印别在 handler 里实时渲染：用
golang/freetype预生成几种尺寸的 PNG 缓存到内存，Size单位是 1/64 磅，传 16 要写16 * 64 - 叠加用
draw.Over（混合 alpha），不是draw.Src（覆盖），位置计算用相对坐标如orig.Bounds().Max.X * 0.9，避免硬写像素值
怎么选第三方库：imaging 还是 bimg 还是纯标准库
没有银弹。选哪个取决于你的部署环境、并发量、格式需求和运维能力。
- 小流量内部工具、只要 JPG/PNG、不想引入 C 依赖 → 用
disintegration/imaging：API 简单，自带缩放+裁剪+水印，imaging.Resize+imaging.Paste两步到位 - 百万级 WebP 处理、CPU 密集、能接受 CGO → 用
h2non/bimg：基于 libvips，内存占用低 70%，但需部署时装系统依赖 - 极致轻量、只做裁剪、不怕多写几行 → 纯标准库 +
image.SubImage（零拷贝） +draw.Draw，但你要自己 handle 所有格式 decode 和 color space 转换 - 别用
nfnt/resize做水印叠加——它不支持 alpha 合成，叠加后背景变黑
最易被忽略的一点：水印图的 DPI 设置和字体基线偏移必须匹配目标图渲染环境，否则文字位置飘、粗细失真；这跟裁剪参数校验一样，不是“可选优化”，是上线前必须验证的硬性条件。
