c.MultipartForm比c.FormFile更适合多文件场景，因其返回multipart.Form，其中form.File是map[string][]multipart.FileHeader，可完整获取同名或不同名字段的所有文件头并按字段归类处理。
c.MultipartForm 为什么比 c.FormFile 更适合多文件场景
因为 c.FormFile 只返回单个 *multipart.FileHeader，而多文件上传时前端可能发来同名字段（如 <input type="file" name="photos" multiple>）或多个不同名字段（如 avatar、id_card），c.MultipartForm 才能完整拿到所有文件头信息。
它返回的是 *multipart.Form，其中 form.File 是 map[string][]*multipart.FileHeader 类型——键是表单字段名，值是该字段对应的所有文件头切片。这让你能按字段归类、统一校验、控制顺序。
- 调用
c.MultipartForm()会一次性解析整个 multipart body，包括所有文件头和文本字段，后续再调c.PostForm或c.FormFile不会重复解析 - 如果只用
c.FormFile循环取同名字段（比如c.FormFile("files")多次），Gin 不支持重放，第二次起就返回nil, err - 并发量大时注意内存：所有文件头都进内存，若单请求含上百个文件，
form.File的 map 和 slice 开销明显，此时应考虑流式处理（见下节）
空文件、nil 文件指针导致 panic 的真实原因与修复
常见写法 if file == nil 判断上传是否成功，这是错的。Go 中 multipart.File 是接口类型，即使底层值为 nil，接口变量本身也可能非 nil，直接 io.Copy(out, file) 就 panic：invalid memory address or nil pointer dereference。
正确逻辑只看 err：只有 err == nil 时，file（或 form.File 中的每个 *multipart.FileHeader）才可安全使用。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 对每个
*multipart.FileHeader，必须先检查header != nil—— 因为c.MultipartForm()返回的切片里可能含nil元素（例如前端传了空 input） - 哪怕
header非nil，也要检查header.Size == 0，避免保存空文件覆盖目录或触发后续逻辑异常 - 不要跳过
err直接用form.File["xxx"]，若字段名不存在，该 key 对应的切片是nil，len(form.File["xxx"])会 panic
大文件或多文件上传时内存爆满怎么办
c.MultipartForm 和 c.FormFile 都会把文件头甚至小文件内容加载进内存，默认上限是 32MB（MaxMultipartMemory）。超过就写临时文件，但若磁盘不可写或权限不足，直接报 http: no such file 或 permission denied。
真正的大文件（>100MB）或高并发多文件上传，必须绕过 Gin 的自动解析，改用流式读取：
- 初始化 router 后禁用默认 multipart 解析：不调
r.MaxMultipartMemory = ...，或设为0（但需自行处理边界） - 在 handler 中用
c.Request.MultipartReader()获取标准multipart.Reader，再循环NextPart() - 每个
part是io.Reader，可直接io.Copy到磁盘、对象存储或校验器，全程无大内存驻留 - 注意：调用
MultipartReader()前不能碰c.Request.Body，也不能提前调c.PostForm或c.FormFile
保存前必须做的三件事，否则就是生产事故
c.SaveUploadedFile 看似方便，但跳过校验就存，轻则文件名被路径遍历（../../../etc/passwd），重则上传恶意脚本到静态目录引发 RCE。
- 文件名过滤：用
path.Base(header.Filename)截掉路径，再白名单校验后缀（如只允许.jpg、.pdf） - 目标目录预检：用
os.Stat(dstDir)确保存在且可写，否则SaveUploadedFile会静默失败或 panic - 内容校验：打开
header.Open()后读取前几 KB，做 MIME 类型检测（别信后缀）、图片尺寸校验、或送入病毒扫描服务
最易被忽略的是：同一个请求里多个文件共用一个字段名时，form.File["files"] 是切片，但每个 header 的 Open() 返回独立的 io.ReadCloser，必须各自 Close()，漏关会导致 fd 耗尽。
