go模板字段访问失败主因是传入数据类型不匹配：需传结构体（字段首字母大写导出）或指针，不可传map；路径问题则因parsefiles基于os.getwd()，推荐parseglob或embed。
模板文件里用 {{.Name}} 却报 template: xxx:1:2: executing "xxx" at <code><.name></.name>: can't evaluate field Name
字段访问失败，本质是传入的数据类型不匹配。Go 的 text/template 严格区分结构体字段可见性（首字母大写）和传入值类型。
- 必须传指针或结构体值，不能传
map[string]interface{}后再指望{{.Name}}—— 它没字段，只有键；真要用 map，得写{{.Name}}对应m["Name"]，但更推荐结构体 - 结构体字段必须导出：写
Name string，别写name string（小写开头不可见） - 调用
t.Execute(w, data)时，data类型要和模板里写的字段名对得上。比如模板写{{.User.Name}}，你就得传一个含User字段的结构体，且User本身也得是导出结构体 - 调试技巧：在执行前加一行
fmt.Printf("%#v\n", data)，看实际传进去的是什么、有没有嵌套层级偏差
想动态控制输出内容，{{if}} 和 {{range}} 总是渲染错位或空行太多
Go 模板默认保留所有空白符，换行、缩进都会原样输出，导致生成的代码里一堆空行或缩进错乱。
- 用
{{- if}}（短横在左）吞掉前面的空白，{{end -}}（短横在右）吞掉后面的换行，比如：{{- if .HasConfig}}config := loadConfig(){{end -}} -
{{range}}遍历切片时，别直接写{{range .Items}}...{{end}}，容易漏掉边界判断；先{{if .Items}}再{{range}}，避免空切片时还留着无意义的上下文 - 生成 Go 源码时特别注意：模板里每行末尾的换行会被保留，所以把逻辑塞在单行里更可控，例如：
{{range .Fields}}func (t *Type) Get{{.Name}}() {{.Type}} { return t.{{.Name}} }{{end}} - 如果需要多行格式化输出（比如生成 YAML/JSON），别依赖模板缩进，改用 Go 代码里
json.MarshalIndent或yaml.Marshal处理后再注入
加载模板时遇到 template: pattern matches no files 或 open xxx: no such file or directory
路径问题最常见，但错误信息不提示到底是工作目录、os.Getwd() 还是 go:embed 在作怪。
- 用
template.ParseFiles()时，路径是相对于当前进程的os.Getwd()，不是源文件所在目录 —— 建议统一用template.ParseGlob("templates/*.tmpl")并确保运行时在项目根目录 - 想打包进二进制？别硬编码路径，改用
embed：import _ "embed"</code><br><code>//go:embed templates/*.tmpl</code><br><code>var tmplFS embed.FS</code><br><code>t := template.New("").Funcs(funcMap)</code><br><code>t, _ = t.ParseFS(tmplFS, "templates/*.tmpl") - 文件扩展名不影响解析，但别用
.go结尾——有些 IDE 或构建工具会误判为源码并报语法错误 - 检查文件权限：Linux/macOS 下确认模板文件不是只读且进程有读取权限；Windows 下注意路径分隔符统一用
/，Go 会自动转换
生成的 Go 代码编译不过，比如缺少 import、字段名大小写不一致、或结构体嵌套错层
模板不校验 Go 语法，它只拼字符串。生成即错，说明模版逻辑和目标代码结构脱节。
立即学习“go语言免费学习笔记（深入）”；
- 别在模板里写完整 import 列表，改用占位符如
{{.Imports}}，然后在 Go 代码里根据.Fields动态生成 import 路径，再传进去 - 字段名大小写必须和结构体定义完全一致 —— Go 是大小写敏感的，
{{.user.Name}}和{{.User.Name}}是两个世界 - 嵌套结构体字段展开要小心：如果模板里写
{{.Req.User.ID}}，但实际传的是struct{ User struct{ ID int } }，没问题；但如果User是指针*User且为nil，就会 panic，加{{with .Req.User}}{{.ID}}{{end}}更安全 - 生成后建议加一步校验：把输出内容写入临时
.go文件，跑go build -o /dev/null xxx.go，失败就立刻报错，别等集成时才发现
事情说清了就结束。最常卡住的点不是语法不会写，而是传进去的结构体和模板里写的字段名对不上，或者路径没搞清到底从哪开始算——这两处多打两行 fmt.Printf，比查文档快得多。
