模板语法错误必须在编译期暴露，应使用 template.Must 包裹 ParseFiles 或 ParseGlob 强制初始化阶段失败，避免运行时 panic；推荐用 templ 替代 html/template 实现 Go 编译期检查，同时注意路径、嵌套定义顺序及空渲染等隐性问题。
模板语法错误必须在编译期暴露，而非等到 HTTP 请求时 panic
Go 的 html/template 默认把语法检查推迟到首次 Execute 时——这意味着你上线后第一个用户触发渲染，才看到 template: xxx: unexpected "if" in template 这类错误。这不是“运行时错误”，而是本该在构建阶段就拦住的解析失败。
真正可行的做法是：用 template.Must 包裹 ParseFiles 或 ParseGlob，强制在初始化阶段 panic 并退出进程。这样 CI 构建或本地 go run 就会直接失败，而不是让带病二进制上线。
-
template.Must不是“优雅处理”，它是断言：如果解析失败，说明模板本身不合法，程序不该启动 - 不要在 handler 里调用
ParseFiles——每次请求都重新解析，既慢又掩盖问题 - 若模板分散在多个目录（如
templates/和emails/），需分别Must加载，避免漏检
使用 go vet 无法检测模板语法，但 templ 可以
go vet 对 html/template 文件完全无感——它只扫描 .go 源码，不读取 .html 文件内容。你改错一个 {{if .User.Name}} 里的点号，go vet 一声不吭。
如果你能接受模板 DSL 替代原生 html/template，templ 是目前唯一能在 go build 阶段报错的方案：它把模板编译成 Go 代码，所有语法、类型、嵌套结构错误都会变成标准 Go 编译错误，比如 undefined field User.Nam 或 cannot use string as int。
立即学习“go语言免费学习笔记（深入）”；
-
templ的静态分析不是“额外插件”，它就是编译流程的一部分；写错class={.Class}会直接卡在go build - 迁移成本存在：需重写模板为
.templ文件，并用templ generate生成 Go 代码 - 不兼容
template.FuncMap等运行时注册机制，所有逻辑必须提前定义为 Go 函数
路径错误导致模板加载失败，根本不是语法问题
常见现象：template.ParseFiles("templates/base.html") 返回 open templates/base.html: no such file or directory，你以为是模板写错了，其实是工作目录不对。
Go 程序永远以当前执行命令的目录为基准解析相对路径，不是源码所在目录。你在项目根目录 go run ./cmd/server，它就去根目录找 templates/；你误在 cmd/server 目录下执行，就会找不到。
- 用
filepath.Abs+runtime.Dir动态计算路径太重，简单做法是统一约定：所有模板放./templates/，并确保 CI 和部署脚本都在项目根目录运行go run - 用
embed.FS嵌入模板可彻底规避路径问题，但需 Go 1.16+，且template.ParseFS仍要检查返回 error - 别信编辑器右键“Run”按钮的路径——它可能在任意目录触发，始终用终端明确 cd 到项目根再执行
嵌套模板中 {{define}} 作用域和调用顺序很关键
{{define "header"}}...{{end}} 必须在被 {{template "header"}} 调用之前完成定义，否则运行时报 template: "header" is not defined。而这个“之前”指的是模板树构建顺序，不是文件字节顺序。
当你用 template.ParseFiles("a.html", "b.html")，Go 按参数顺序依次解析：如果 a.html 里 {{template "header"}}，但 header 定义在 b.html 里，就会失败——因为 a.html 解析完时，header 还没出现。
- 解决方案只有两个：把所有
{{define}}放在第一个文件里，或改用template.New("base").ParseFiles(...)让它们共享同一个模板实例 -
{{template .Name}}这种变量调用方式，要求.Name的值必须是字符串字面量或已存在的模板名，不能是拼接结果（如{{template (printf "%s_header" .Page)}}会 panic） - 调试时用
tmpl.Templates()打印所有已注册模板名，确认目标名称确实在列表里
{{with .User}}...{{end}} 外层没兜底——这些都不会触发 panic，却让页面静默失效。必须靠主动检查 Execute 返回值 + 日志 + 端到端测试覆盖，才能守住底线。 
