本文详解如何在 go 中通过 `html/template` 包向 html 页面传递数据，实现表单元素（如 checkbox）根据服务端逻辑动态渲染选中/未选中状态，包含完整可运行示例与关键注意事项。
在 Go Web 开发中，html/template 是渲染动态 HTML 的核心工具。你遇到的问题——点击“保存”后刷新页面并保持复选框（<input type="checkbox">）处于已勾选状态——本质上是服务端驱动的状态同步：需将用户提交后的状态（如 checked = true）作为数据传入模板，并在 HTML 中用 Go 模板语法控制属性渲染。
⚠️ 注意：你原始 HTML 中存在两个关键错误：
- <form action type="checkbox"...> 语法错误 —— type="checkbox" 属于 <input>，不应出现在 <form> 标签上；
- {{.checked}} 是正确的模板占位符，但必须确保传入的数据结构中存在 checked 字段，且其值能被正确解析为 HTML 属性（如 "checked" 字符串或布尔值）。
✅ 正确做法是：定义一个结构体（或 map）承载表单状态，用 template.ParseFiles() 加载 HTML 模板，并在 HTTP 处理函数中执行 Execute() 渲染。
以下是一个完整、可直接运行的示例：
立即学习“前端免费学习笔记（深入）”；
// main.go
package main
import (
"html/template"
"log"
"net/http"
"strings"
)
// 定义表单数据结构
type FormData struct {
Checked bool // 控制 checkbox 是否显示为已勾选
}
func handler(w http.ResponseWriter, r *http.Request) {
// 判断是否为 POST 提交（即用户点了“save”）
if r.Method == "POST" {
r.ParseForm()
// 若表单中存在名为 "test" 的 checkbox（有值即代表被勾选）
checked := len(r.FormValue("test")) > 0
// 渲染页面时传入已更新的状态
data := FormData{Checked: checked}
tmpl.Execute(w, data)
return
}
// GET 请求：首次访问，checkbox 默认不勾选
tmpl.Execute(w, FormData{Checked: false})
}
var tmpl = template.Must(template.New("index").Parse(`
<!DOCTYPE html>
<html>
<head><title>Go Template Checkbox</title></head>
<body>
<h2>Test Checkbox State</h2>
<form method="POST">
<label>
<input type="checkbox" name="test" value="A" {{if .Checked}}checked{{end}}>
选项 A
</label><br><br>
<input type="submit" value="保存">
</form>
</body>
</html>
`))
func main() {
http.HandleFunc("/", handler)
log.Println("Server starting on :8080...")
log.Fatal(http.ListenAndServe(":8080", nil))
}? 关键说明：
- 使用 {{if .Checked}}checked{{end}} 替代 {{.checked}}：Go 模板中不会自动将布尔值转为 HTML 属性字符串；必须显式判断并插入 checked 字符串（注意大小写，HTML 属性名小写）；
- r.FormValue("test") 在 checkbox 未勾选时返回空字符串，勾选时返回 value="A" 对应的 "A"，因此用 len > 0 判断；
- 模板中 <input> 必须包裹在 <form method="POST"> 内，action 可省略（默认提交到当前 URL）；
- 使用 template.Must() 确保模板解析失败时立即 panic，便于开发阶段排错。
? 进阶提示：
- 如需支持多选或更复杂状态，可将 FormData 改为含 Selected []string 的结构，并在模板中用 {{range}} 遍历渲染；
- 生产环境请务必对用户输入做校验与转义（html/template 默认已做 XSS 转义，安全可靠）；
- 静态资源（CSS/JS）建议分离部署，或使用 http.FileServer 配合路由处理。
通过以上方式，你就能让 Go 后端真正“记住”并响应用户的表单交互，实现流畅的服务器端状态驱动 UI。
