c.PostForm 只能取第一个同名字段值，因其底层调用 http.Request.FormValue，而 Go 标准库规定该方法仅返回首个匹配键的值；多选需用 c.PostFormArray 或切片类型结构体绑定。
前端提交含多选、数组、重复字段名的表单时，Gin 默认的 c.PostForm 只能取第一个值，必须用 c.PostFormArray 或结构体绑定配合 form 标签显式声明才能正确获取全部值。
为什么 c.PostForm 拿不到多个同名字段？
Gin 的 c.PostForm("tags") 内部调用的是 http.Request.FormValue，它只返回第一个匹配键的值 —— 这是 Go 标准库行为，不是 Gin 的 bug。遇到 checkbox 多选、<select multiple></select> 或手动重复写多个 <input name="role"> 时，后端只会收到一个字符串。
- 浏览器实际发送的是
role=admin&role=editor&role=viewer -
c.PostForm("role")返回"admin"（首个） -
c.PostFormArray("role")返回[]string{"admin", "editor", "viewer"} - 若用结构体绑定，字段类型必须是切片，且
form标签名要完全一致
ShouldBind 绑定多值字段的 struct 写法
结构体字段类型决定是否支持多值：只有切片（[]string、[]int）才能接收多个同名参数；普通字符串或整型会静默截断为第一个值。
- 错误写法：
Roles string `form:"role"`→ 只存"admin" - 正确写法：
Roles []string `form:"role"`→ 得到完整切片 - 注意：HTML 中所有
name="role"的 input 必须拼写完全一致，大小写敏感 - 如果字段带空格或特殊字符（如
user[roles]），Gin 不识别，需改用c.Request.Form["user[roles]"]手动解析
示例结构体：
前端设计优化skill
下载
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
立即学习“go语言免费学习笔记（深入）”；
type UserForm struct {
Name string `form:"name" binding:"required"`
Roles []string `form:"role" binding:"required"`
Tags []int `form:"tag_id" binding:"gt=0"`
}
文件上传 + 多值表单混合场景的坑
当表单同时含 <input type="file"> 和多个同名文本字段时，必须用 c.ParseMultipartForm 预加载，否则 c.PostFormArray 和 ShouldBind 都会返回空。
- 未调用
ParseMultipartForm前，c.Request.MultipartForm为 nil，所有表单解析方法失效 - Gin 默认不自动调用，需在路由开头显式加：
c.Request.ParseMultipartForm(32 （32MB 限制） - 或者更稳妥：直接用
c.ShouldBind，它内部会触发ParseMultipartForm，但前提是结构体字段类型和标签匹配 - 切记：文件字段不能放在结构体里用
form标签绑定，要用c.FormFile("avatar")单独处理
调试时怎么确认前端到底发了什么？
别猜，直接打印原始 form 数据：
err := c.Request.ParseMultipartForm(10 后，执行 <code>log.Printf("%+v", c.Request.MultipartForm)- 或用
c.Request.PostForm（返回url.Valuesmap）看键值对全貌 - 常见陷阱：前端 JS 用
FormData.append("tags", "a"); FormData.append("tags", "b")是合法的，但若用FormData.set("tags", ...)就会覆盖 - Chrome DevTools 的 Network → Payload tab 要切换到 “View parsed” 才能看到结构化数据，否则只显示原始字符串
多值绑定本身不难，难在前后端约定松散时，谁都没法保证 name 一致、类型匹配、编码正确 —— 最小验证单元永远是“打印原始请求数据”。
