c.PostForm 拿不到 multipart 表单普通字段，因其依赖的 formCache 仅在成功调用 ParseMultipartForm 后填充；若未显式解析（如未调用 FormFile、MaxMultipartMemory 设置不当或请求超限），缓存为空，PostForm 始终返回空字符串。
为什么 c.PostForm 拿不到 multipart 表单里的普通字段？
因为 c.PostForm 依赖 Gin 内部的 formCache，而这个缓存只有在调用 ParseMultipartForm 后才被填充。如果你没显式触发解析（比如没调用 c.Request.FormFile 或没设 MaxMultipartMemory），c.PostForm("name") 就会返回空字符串——哪怕表单里只有文本字段、没传文件。
Gin 的 getFormCache 实现里会尝试调用 r.ParseMultipartForm(c.engine.MaxMultipartMemory)，但一旦失败（比如请求体超限或格式非法），就直接跳过填充 formCache，后续所有 PostForm 都失效。
- 确保
gin.Engine.MaxMultipartMemory设置合理（默认 32MB），且 ≥ 实际预期上传总大小 - 如果只处理纯文本字段，改用
c.ShouldBind(&struct{})更可靠，它会主动触发完整解析 - 避免混用
c.PostForm和c.Request.MultipartForm：前者是缓存视图，后者是原始解析结果，二者不自动同步
如何安全读取并保存上传文件？
用 c.Request.FormFile("file") 是最简路径，但它返回的 file 是一个 io.ReadCloser，必须 defer file.Close()；否则句柄泄漏，临时文件也不会清理。
保存时常见错误是直接用 os.Create("./uploads/" + filename)，但 Go 不会自动创建父目录。如果 uploads/2024/ 不存在，就会报 open uploads/2024/x.jpg: no such file or directory。
立即学习“go语言免费学习笔记（深入）”；
- 先调用
os.MkdirAll(filepath.Dir(dstPath), 0755)确保路径存在 - 对
header.Filename做基础校验（如过滤../路径遍历） - 用
io.Copy流式写入，别把整个文件 load 到内存里 - 不要忽略
file.Close()和目标文件out.Close()的错误，它们可能暴露磁盘满或权限问题
ParseMultipartForm 的 limit 参数到底控制什么？
r.ParseMultipartForm(32 中的 <code>32 （即 32MB）**只限制 form 字段（非文件部分）的内存缓冲上限**，不是整个请求体大小限制。文件内容仍会流式写入临时磁盘，不受此值约束。
真正拦住超大请求的是 HTTP 底层：如果请求体总大小 > MaxMultipartMemory，ParseMultipartForm 还没执行完，http.Request 就会在读 body 时 panic 报 http: request body too large。
- 必须在 handler 开头就调用
r.ParseMultipartForm(limit)，不能等到要读文件时才调 - 若需全局限制上传总大小（含文件），得用
http.MaxBytesReader包裹r.Body，或在中间件里检查r.ContentLength - 临时文件位置由
os.TempDir()决定，无法通过ParseMultipartForm修改；如需自定义，得替换r.Body并实现自己的multipart.Reader
Gin ShouldBind 能否处理 multipart 表单里的文件？
不能。c.ShouldBind(&v) 只处理 application/x-www-form-urlencoded 和 application/json，对 multipart/form-data 中的文件字段完全忽略。结构体 tag 里的 form:"avatar" 只能绑定普通字段，binding:"required" 也验证不了文件是否存在或大小是否合规。
想同时绑定文本字段和文件，得拆开处理：先用 ShouldBind 绑定结构体，再单独用 FormFile 提取文件，最后手动组合逻辑。
- 文件元信息（
Filename、Size、Header）只能从FormFile或MultipartForm.File获取 - 别指望
binding:"max=1048576"校验文件大小——validator 不知道文件在哪，它只看结构体字段值 - 如果表单字段名和结构体字段名不一致，
FormFile仍按 HTML 的name属性查找，和 struct tag 无关
file.Close()，对应临时文件就一直留在 os.TempDir() 下**。线上跑几天后，磁盘可能被占满，而错误日志里只显示“no space left on device”，根本看不出根源。 
