本文讲解如何基于 go 结构体切片，在 html 模板中安全、清晰地生成一组关联的复选框，并正确绑定初始选中状态，适用于问卷系统等场景。
本文讲解如何基于 go 结构体切片，在 html 模板中安全、清晰地生成一组关联的复选框，并正确绑定初始选中状态，适用于问卷系统等场景。
在 Go Web 开发中，将结构化数据（如 []Answer）渲染为 HTML 表单控件（如复选框组）是常见需求。但直接在 http.HandlerFunc 中拼接 HTML 字符串（如 fmt.Fprintf）既不安全也不可维护。推荐做法是使用 Go 原生 html/template 包，结合结构体字段与模板指令实现声明式渲染。
首先，优化数据模型设计：避免不必要的嵌入（embedding），改用显式字段提升语义清晰度和可维护性：
type Answer struct {
AnswerId int
AnswerText string
Selected bool
}
// 直接定义为切片类型，语义更明确
type Answers []Answer
type Question struct {
QuestionId int
QuestionText string
Answers Answers // 显式字段，非嵌入
}接着，在 HTTP 处理函数中，使用 template.Parse 加载模板字符串（或从文件读取），再通过 Execute 将结构体实例注入模板上下文：
func ViewHandler(w http.ResponseWriter, r *http.Request) {
const tpl = `
<!DOCTYPE html>
<html>
<head><title>问卷</title></head>
<body>
<form method="POST" action="/submit">
<h3>{{.QuestionText}}</h3>
{{range .Answers}}
<label>
<input
type="checkbox"
name="answer_ids"
value="{{.AnswerId}}"
{{if .Selected}}checked{{end}}>
{{.AnswerText}}
</label><br>
{{end}}
<button type="submit">提交</button>
</form>
</body>
</html>`
t, err := template.New("question").Parse(tpl)
if err != nil {
http.Error(w, "模板解析失败", http.StatusInternalServerError)
return
}
question, err := loadPage()
if err != nil {
http.Error(w, "数据加载失败", http.StatusInternalServerError)
return
}
// 将整个 Question 实例传入模板，字段可通过 .QuestionId、.Answers 等访问
if err := t.Execute(w, question); err != nil {
http.Error(w, "模板执行失败", http.StatusInternalServerError)
}
}关键点说明：
- ✅ {{range .Answers}} 遍历 Question.Answers 切片，每次迭代中 . 指向当前 Answer 实例；
- ✅ name="answer_ids" 使用相同 name 值使浏览器将多个勾选项打包为同名数组（服务端可通过 r.Form["answer_ids"] 获取）；
- ✅ value="{{.AnswerId}}" 确保提交时传递唯一标识，而非文本内容，便于后端准确识别用户选择；
- ✅ {{if .Selected}}checked{{end}} 根据结构体字段动态控制 checked 属性，实现初始状态同步；
- ⚠️ 注意 XSS 防护：{{.AnswerText}} 会自动 HTML 转义；若需渲染富文本，请改用 {{.AnswerText | safeHTML}} 并确保内容可信；
- ⚠️ 字段导出要求：所有需在模板中访问的字段（如 AnswerId, AnswerText, Selected）必须首字母大写（即导出），否则模板无法读取。
最后，服务端接收提交时可这样解析复选结果：
func submitHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "仅支持 POST", http.StatusMethodNotAllowed)
return
}
r.ParseForm()
selectedIDs := r.Form["answer_ids"] // 类型为 []string，如 ["1", "3"]
// 转换为 int 并处理业务逻辑...
}通过结构化数据 + 模板驱动的方式，不仅代码更健壮、可测试，也自然支持状态回填、多语言、SEO 友好等进阶需求。
