必须显式调用 r.ParseForm() 才能读取表单数据，否则 r.FormValue 返回空；ParseForm 解析 URL 查询和表单体（不含文件），含文件需用 ParseMultipartForm 并设 MaxMemory；r.PostForm 仅含 POST 数据，优先使用以避免 GET 参数干扰。
如何用 http.Request.ParseForm 正确读取表单数据
Go 标准库不自动解析表单，必须显式调用 ParseForm 才能访问 r.Form 和 r.PostForm。跳过这步直接读 r.FormValue("name") 可能返回空值，尤其在 POST 请求中。
常见错误现象：前端提交了 username=alice，但后端打印 r.FormValue("username") 为空；或 r.Method 是 POST 却无法获取任何字段。
- 必须在读取表单前调用
r.ParseForm()，且仅需一次 —— 多次调用会 panic -
ParseForm同时解析 URL 查询参数（r.URL.Query()）和请求体（application/x-www-form-urlencoded或multipart/form-data），但对后者只解析非文件字段 - 若表单含文件上传，应改用
r.ParseMultipartForm，否则ParseForm会忽略文件字段且不报错
区分 r.Form 与 r.PostForm 的实际用途
r.Form 包含所有键值（GET 查询 + POST 表单），而 r.PostForm 仅含 POST 请求体中的键值（不含 URL 参数）。多数场景下应优先用 r.PostForm 避免意外覆盖。
例如：请求 URL 是 /login?debug=1，POST body 是 username=admin&password=123，则：
立即学习“go语言免费学习笔记（深入）”；
fmt.Println(r.Form) // map[debug:[1] username:[admin] password:[123]] fmt.Println(r.PostForm) // map[username:[admin] password:[123]]
- 若业务逻辑要求严格区分来源（如只允许 POST 提交用户名），用
r.PostForm.Get("username") -
r.FormValue("key")是快捷方式，等价于r.PostFormValue("key")（注意：它不查r.URL.Query，这点文档易误导） - 所有值都是字符串切片，即使字段只出现一次，也要用
Get取首个值，或用["key"][0]（需判空）
处理 multipart/form-data（含文件上传）的正确流程
当 HTML 表单设 enctype="multipart/form-data"，ParseForm 不解析文件字段，必须用 ParseMultipartForm，且需预先设置内存限制。
典型错误：未调用 ParseMultipartForm 就尝试 r.MultipartForm.File["avatar"]，结果为 nil；或未设 MaxMemory 导致大文件直接写磁盘而无提示。
- 必须先调用
r.ParseMultipartForm(32 （32MB 内存上限），否则r.MultipartForm为nil - 文件通过
r.MultipartForm.File["fieldname"]获取，返回[]*multipart.FileHeader - 文本字段仍可通过
r.PostFormValue("title")读取，无需从MultipartForm.Value手动取 - 读取文件内容需用
fileHeader.Open()得到io.ReadCloser，务必 defer 关闭
为什么 r.Body 不能反复读取？如何安全复用
Go 的 http.Request.Body 是单次读取流，调用 ParseForm 或 ParseMultipartForm 会消耗它。之后再读 r.Body 会得到空内容 —— 这是生产环境常见静默失败点。
- 若需原始请求体（如验签、日志、JSON 解析），应在调用任何
ParseXXX前用io.ReadAll(r.Body)保存，并用bytes.NewReader重置r.Body - 不要依赖
r.Body在中间件和 handler 中多次读取；标准做法是中间件解析后把结构体塞进r.Context() - 对于 JSON API，建议直接用
json.NewDecoder(r.Body).Decode(&v)，避免碰ParseForm—— 二者互斥
表单解析本身不复杂，但 Go 的显式流控制和一次性读取特性，让顺序和副作用特别关键。最容易被忽略的是：没检查 ParseForm 返回的 error（比如请求体超限或编码错误），导致后续读取始终为空却无提示。
