text/template 是 Go 中轻量安全的文本生成工具，用于配置、邮件、代码等场景，但需注意字段导出、map 访问、路径解析、空白控制、函数注册及非 nil 数据传入等关键问题。
text/template 不是用来“学教程”的，它是 Go 里一个轻量、安全、无依赖的文本生成工具——你用它写配置、发邮件、生成代码、拼 SQL 片段，甚至做静态站点渲染，都行；但一旦传错数据类型、路径没对上、字段没导出，它就静默失败或直接 panic。
模板执行时 panic: “can't evaluate field XXX” 怎么修？
这是最常卡住人的错误，本质不是语法错，而是反射访问失败。
-
text/template只能访问导出字段（首字母大写），type User { name string }中的name永远不可见，必须写成Name string - 别传
map[string]interface{}却指望{{.Name}}—— map 没“字段”，只有键；要这么写就得用{{.Name}}（对应m["Name"]），但更稳的方式是用结构体 - 嵌套访问如
{{.Profile.Addr.City}}，要求Profile、Addr、City全是导出字段，且每层值非 nil；nil指针访问会 panic，不是跳过 - 调试建议：执行前加
fmt.Printf("%#v\n", data)，一眼看清传进去的是啥、有没有多一层 struct 包裹
从文件加载模板总报 “pattern matches no files”？
template.ParseFiles() 的路径是相对 os.Getwd()（当前工作目录），不是源码位置，也不是二进制所在目录。
- 开发时运行
go run main.go，工作目录通常是项目根；但打包后用./app启动，若不在项目根下运行，路径就断了 - 推荐改用
template.ParseGlob("templates/*.tmpl")，更可控；或用embed.FS打包进二进制：import _ "embed"<br>//go:embed templates/*.tmpl<br>var tmplFS embed.FS<br>t := template.New("").ParseFS(tmplFS, "templates/*.tmpl") - 别信错误信息里说的“no such file”，它不告诉你当前
os.Getwd()是哪——加一行fmt.Println(os.Getwd())看清再说
生成代码/配置时空行和缩进乱成一团？
模板默认原样保留所有空白符，换行、空格、制表符全照搬输出，这不是 bug，是设计。你要的是“可读模板”，它只管“精确输出”。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 用短横吞掉空白：
{{- if .Cond}}吞前面空白，{{end -}}吞后面换行；{{- range .Items}}...{{end -}}能压平循环产生的多余空行 - 别在模板里靠缩进来格式化输出（比如想生成漂亮 YAML）——先用
yaml.MarshalIndent或json.MarshalIndent处理好字符串，再注入模板 - 生成 Go 代码时，把逻辑塞单行更可靠：
{{range .Fields}}func (t *T) Get{{.Name}}() {{.Type}} { return t.{{.Name}} }{{end}}，避免换行干扰编译
想在模板里调用 strings.Title 或自定义逻辑？
text/template 不允许直接调用未注册函数，也不支持结构体方法调用（哪怕是指针接收者）；所有函数必须显式注册进 FuncMap。
- 注册方式：
t := template.New("").Funcs(template.FuncMap{<br> "title": strings.Title,<br> "toUpper": strings.ToUpper,<br>}) - 模板中才能写
{{.Name | title}}或{{title .Name}}；没注册就报function "title" not defined - 注意：注册函数不能有副作用（比如
log.Println），因为模板可能并发执行、多次重试；需要上下文（如 HTTP request）的逻辑，应提前算好结果，塞进数据结构里再传给Execute
传 nil 给 Execute 一定会 panic，哪怕你模板开头写了 {{if .}}... —— 因为 . 本身访问就崩了。这事没法靠模板逻辑兜底，只能靠代码层守门：要么确保传的是非 nil 值（结构体字面量、指针、空 struct），要么封装一层 SafeExecute 提前校验。这是最容易被忽略、也最难 debug 的一点。
