本文详解如何在 go 中使用 html/template 渲染动态 html 页面，重点解决初学者常见的表单复选框（checkbox）状态持久化问题——即用户提交后页面重载时自动保留已勾选状态。
在 Go Web 开发中，html/template 是标准库提供的安全、高效模板引擎，它支持数据绑定、条件渲染和循环等能力。但初学者常误用语法（如将 type="checkbox" 错写在 <form> 标签上），或忽略 checkbox 的“已选中”逻辑本质：HTML 中 checkbox 是否被勾选，取决于其是否含有 checked 属性（而非 value 或某个变量名）。
你的原始 HTML 存在两个关键问题：
- <form action type="checkbox" ...>：type="checkbox" 属于 <input>，不是 <form> 的合法属性；
- {{.checked}} 试图直接插入布尔值，但 Go 模板中需显式判断并输出 checked 字符串（Go 中 true 不会自动转为 checked 属性）。
✅ 正确做法是：
- 在 Go 后端根据业务逻辑（如请求参数、数据库状态）决定 checkbox 是否应被勾选；
- 将布尔值传入模板，并用 {{if .IsChecked}}checked{{end}} 控制属性存在与否；
- 使用 http.HandlerFunc 处理 GET（显示页面）和 POST（接收表单）请求。
以下是完整可运行示例：
立即学习“前端免费学习笔记（深入）”；
// main.go
package main
import (
"html/template"
"log"
"net/http"
"strings"
)
type PageData struct {
IsChecked bool
}
func handler(w http.ResponseWriter, r *http.Request) {
switch r.Method {
case "GET":
// 初始访问：默认未勾选
data := PageData{IsChecked: false}
tmpl.Execute(w, data)
case "POST":
r.ParseForm()
// 检查表单中是否有名为 "test" 的值（checkbox 提交时仅当被勾选才发送）
isChecked := len(r.FormValue("test")) > 0
data := PageData{IsChecked: isChecked}
tmpl.Execute(w, data)
}
}
var tmpl = template.Must(template.New("index").Parse(`
<html>
<head><title>Checkbox Demo</title></head>
<body>
<h2>Test Checkbox</h2>
<form method="POST">
<label>
<input type="checkbox" name="test" value="A" {{if .IsChecked}}checked{{end}}>
Option A
</label><br><br>
<input type="submit" value="Save">
</form>
</body>
</html>
`))
func main() {
http.HandleFunc("/", handler)
log.Println("Server starting on :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}? 关键说明：
- {{if .IsChecked}}checked{{end}} 是模板中控制属性存在的标准写法；直接写 {{.IsChecked}} 会输出 true/false 字符串，无法触发浏览器勾选行为；
- checkbox 提交机制：只有被勾选的 checkbox 才会在 POST 请求中出现在表单数据里，因此 r.FormValue("test") 非空即表示用户勾选了它；
- 使用 template.Must() 可在启动时捕获模板语法错误，避免运行时 panic；
- 建议始终用 <label> 包裹 <input> 提升可访问性与点击体验。
? 进阶提示：若需多选、保存至数据库或跨请求保持状态，可结合 session（如 gorilla/sessions）或 URL 参数传递，但核心原则不变——服务端决定 .IsChecked 的值，模板只负责条件渲染。
掌握这一模式，你就能可靠地实现任何基于表单状态的动态页面交互。
