gin模板中空字段默认渲染为空字符串而非panic，主因是未导出字段、nil指针或空map/slice；应确保字段首字母大写、传入非nil指针，并用{{with}}/{{if}}安全判空，推荐在handler层预处理数据统一空值策略。
模板中空字段直接显示空白或 panic？先确认数据是否传进来了
很多问题其实不是模板语法不对，而是 .User.Name 本身是 nil 或未导出字段（比如写成 name 而非 Name），导致模板里访问时静默跳过或 panic。Gin 的 html/template 对未导出字段、nil 指针、空 map/slice 都不报错，只渲染为空字符串——这会让“默认值”根本没机会生效。
检查点必须包括：
-
User结构体中字段名首字母大写（Name✅，name❌） - 传入的
User是指针且非nil（&User{}✅，nil❌） - 避免用
map[string]interface{}传参，字段拼错时编译器不报错，运行时才丢数据
用 {{with}} + {{else}} 处理空字符串和零值
Go 模板没有三元运算符，但 {{with}} 是最自然的空值兜底方式。它会判断管道值是否为“空”（""、0、nil、false、空 slice/map），只有非空才执行内部块。
例如显示用户名，空时 fallback 为 "游客"：
{{with .User.Name}}
<span>{{.}}</span>
{{else}}
<span>游客</span>
{{end}}
注意：{{with}} 会改变当前作用域（. 变成 .User.Name），所以里面用 {{.}} 直接输出值；如果需要同时访问其他字段，改用 {{if}} 更稳妥。
对数字、布尔、嵌套字段做更精细的空值判断
{{with}} 对 0 和 false 也会触发 {{else}}，有时不符合业务预期（比如年龄为 0 是合法值）。这时得用显式比较：
- 判断字符串是否为空：
{{if eq .User.Name ""}} - 判断整数是否为零但允许显示：
{{if ne .User.Age 0}} - 判断嵌套字段是否存在且非空：
{{if and .User.Profile .User.Profile.Avatar}}
常见错误是写成 {{if .User.Profile.Avatar}}，一旦 .User.Profile 是 nil，整个表达式 panic。必须用 and 短路判断逐层校验。
在 handler 层预处理数据，比模板里硬刚更可靠
模板里堆逻辑容易失控，尤其涉及多字段组合判断（如“显示昵称，否则显示邮箱前缀，否则显示‘未命名’”）。更推荐在 c.HTML() 前统一补全：
data := gin.H{
"UserName": coalesceString(u.Name, u.Email[:strings.Index(u.Email, "@")], "未命名"),
"IsAdmin": u.Role == "admin",
"AvatarURL": coalesceString(u.Avatar, "/static/avatar-default.png"),
}
c.HTML(200, "profile.html", data)
其中 coalesceString 是你自己写的工具函数，按顺序取第一个非空字符串。这样模板里就只剩 {{.UserName}}，干净、可测、易维护。
真正容易被忽略的是：前端 JS 经常假设后端返回的字段一定存在且类型稳定，模板里用 {{with}} 或 {{if}} 隐藏了字段，但 JSON 接口可能仍返回 null —— 如果你共用同一套数据结构渲染 HTML 和提供 API，空值策略必须统一，不能一个地方补 ""，另一个地方留 null。
