Go语言需组合net/http、image/*及第三方库实现头像上传与裁剪；标准库不支持自由区域裁剪；接收multipart/form-data时须先调用r.ParseMultipartForm(32
Go 语言本身不内置图片裁剪和文件上传处理，必须组合 net/http、image/* 包和第三方库（如 golang.org/x/image/draw 或 github.com/disintegration/imaging）才能完成头像上传 + 裁剪全流程。纯标准库能读取、解码、缩放，但无法做自由区域裁剪（比如用户拖拽选框后的矩形截取）。
接收 multipart/form-data 文件上传时，别漏掉 ParseMultipartForm
很多新手直接读 r.Body 或用 r.FormFile 却没调用 ParseMultipartForm，导致 r.MultipartForm 为 nil，r.FormFile 返回 http.ErrNotMultipart 或空文件。
- 必须在读取文件前调用
r.ParseMultipartForm(32 （例如限制 32MB 内存缓冲） - 若表单含其他字段（如
crop_x、crop_y），也得从r.MultipartForm.Value里取，不能用r.FormValue - 不调用该方法就访问
FormFile，Go 会静默跳过解析，返回空或错误，不易排查
裁剪逻辑必须先解码图像，再用 imaging.Crop 或手动操作 image.Rectangle
标准库 image.Decode 只返回 image.Image 接口，没有裁剪方法；直接对原始字节裁剪毫无意义——那是二进制流，不是像素矩阵。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先用
image.Decode得到img，再确认其类型是否支持裁剪（*image.RGBA最稳妥） - 推荐用
github.com/disintegration/imaging：它封装了坐标转换、抗锯齿缩放和矩形裁剪，一行就能写：imaging.Crop(img, image.Rect(x, y, x+w, y+h)) - 如果坚持用标准库，需手动构造
image.Rectangle并调用draw.Draw复制子区域，注意原图坐标系原点在左上角，且SubImage返回的是共享底层数组的视图，修改会影响原图
保存裁剪后图片时，注意 MIME 类型与编码格式匹配
前端传的是 image/jpeg，后端却用 png.Encode 保存，结果文件头是 PNG 但扩展名是 .jpg——浏览器打不开，iOS 相册拒绝识别。
- 从
http.Header.Get("Content-Type")或文件扩展名推断源格式，优先以image.Decode返回的string格式名为准（如"jpeg"、"png"） - 保存时用对应 encoder：
jpeg.Encode/png.Encode/gif.Encode，不要硬编码成某一种 - JPEG 编码需传
&jpeg.Options{Quality: 85}，否则默认质量极低（约 75），头像发灰；PNG 则无需质量参数
裁剪坐标的合法性校验常被跳过：用户提交 x=-100 或 w=9999，程序直接代入 image.Rect，导致 panic: rectangle not within image bounds。必须在 decode 后立刻检查 x,y,w,h 是否落在 img.Bounds() 内，并做 clamp 处理——这不是防御性编程的可选项，是上线必做步骤。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
