Gin模板不自动回显表单数据，需手动传值并在HTML中用{{.Field}}显式填充value或checked属性；c.HTML()仅渲染模板，不解析请求体或反向注入，故提交失败后若未传参则字段为空。
Gin 模板本身不自动回显表单数据，必须手动把值从后端传入模板，并在 HTML input 的 value 或 checked 属性中显式写入。没有“绑定即回显”这种魔法行为。
为什么 c.HTML() 不会自动填充表单
Gin 的 c.HTML() 只负责渲染模板，它不会读取请求体、解析参数、再反向注入到 HTML 标签里——这和 Vue/React 的双向绑定或 Django 的 Form 类完全不同。你提交失败后重定向回表单页，若没主动传参，模板就是一张“空画布”。
常见错误现象：
- 用户填了一半表单，提交报错（比如邮箱格式不对），跳转回来后所有字段全空了
- 用
c.PostForm("xxx")取值后没塞进c.HTML()的 data 参数，模板里{{.Username}}渲染为空字符串
如何手动实现回显：传值 + 模板插值
核心就两步：后端把当前请求中的字段值（无论原始输入还是校验失败后的残留值）作为结构体或 map 传给 c.HTML()；模板里用 {{.Field}} 填入 value 或控制 checked。
示例场景：注册页含用户名、邮箱、兴趣标签（多选 checkbox）：
type RegisterForm struct {
Username string `form:"username"`
Email string `form:"email"`
Colors []string `form:"colors[]"`
}
func registerHandler(c *gin.Context) {
if c.Request.Method == "POST" {
var form RegisterForm
if err := c.ShouldBind(&form); err != nil {
// 校验失败，原样把已提交的值传回去
c.HTML(200, "register.html", gin.H{
"form": form,
"error": err.Error(),
})
return
}
// 处理成功逻辑...
c.JSON(200, gin.H{"ok": true})
return
}
// GET 请求：首次访问，传空结构体
c.HTML(200, "register.html", gin.H{"form": RegisterForm{}})
}
对应模板 register.html 片段：
<input type="text" name="username" value="{{.form.Username}}">
<input type="email" name="email" value="{{.form.Email}}">
<label><input type="checkbox" name="colors[]" value="red" {{if in .form.Colors "red"}}checked{{end}}> Red</label>
<label><input type="checkbox" name="colors[]" value="green" {{if in .form.Colors "green"}}checked{{end}}> Green</label>
注意：in 是 Gin 内置函数（需确保使用 gin.Default() 或手动注册），用于判断 slice 是否包含某元素。
容易踩的坑：GET 和 POST 混用时的值来源混乱
回显依赖“当前上下文的数据源”，但这个源容易搞错：
- 用
c.Query()取 GET 参数，却在 POST 失败后还拿它回显——这时应优先用ShouldBind解析后的结构体字段 - 对 checkbox / radio，不能只靠
value="{{.form.Colors}}"，因为它是 slice，得用{{if in ...}}逐个判断 - 密码字段（
type="password"）原则上不应回显，即使你有值也别写进value，这是安全常识 - 如果用了重定向（
c.Redirect()）而不是直接c.HTML()，那请求上下文就丢了，必须通过c.SetCookie()或 session 存临时值——但更推荐直接c.HTML()渲染，避免跳转丢失状态
进阶：统一错误处理 + 回显封装
重复写 c.HTML(200, "xxx", gin.H{...}) 很麻烦。可封装一个辅助函数：
func renderWithForm(c *gin.Context, tmpl string, form interface{}, err error) {
data := gin.H{"form": form}
if err != nil {
data["error"] = err.Error()
}
c.HTML(200, tmpl, data)
}
然后在 handler 里直接调用：
if err := c.ShouldBind(&form); err != nil {
renderWithForm(c, "register.html", form, err)
return
}
真正复杂的是多层嵌套结构体或动态字段（如自定义表单项列表），这时模板需要递归或 range 遍历，且后端传值必须保持结构一致——稍有不匹配，{{.X.Y.Z}} 就静默失败，什么也不显示。
