template.parsefiles 路径以当前工作目录为准，非源码目录；应使用 os.executable()+filepath.dir() 定位二进制目录拼接路径，或改用 embed.fs；funcmap 必须在 parse 前注册；结构体字段需首字母大写才可导出；空白符用 {{- }} 控制。
template.ParseFiles 读不到文件？路径是相对 main.go 的
Go 的 text/template 默认以当前工作目录（不是源码目录）为基准解析文件路径，很多新手在 IDE 里点运行，工作目录却是项目根目录；一换到终端执行，又可能在子目录下运行，ParseFiles 就报 open xxx: no such file or directory。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
os.Executable()+filepath.Dir()定位二进制所在目录，再拼接模板路径，比如：filepath.Join(filepath.Dir(exePath), "templates", "handler.tmpl") - 开发期可加一句
fmt.Println("working dir:", os.Getwd())快速确认当前路径 - 模板文件别放
go build不会打包进去的目录（如./templates），真要嵌入得用embed.FS+template.ParseFS
模板里调用自定义函数失败：funcMap 必须在 Parse 前注册
template.FuncMap 是只读映射，注册后调用 Parse 或 ParseFiles 才会把函数绑定进模板 AST；如果先 Parse 再 Funcs，函数压根不会生效，渲染时直接 panic：function "toUpper" not defined。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 顺序必须是：
t := template.New("x").Funcs(myFuncMap).ParseFiles(...) - 常见自定义函数如
toUpper、snakeCase、join，记得返回值类型要匹配模板内调用方式（比如{{ join .Fields "," }}要求函数接收[]string, string） - 函数内部别 panic，应返回错误并让模板用
{{ if .Err }}...{{ end }}处理，否则整个渲染中断
结构体字段渲染为空？首字母小写或没导出
Go 模板只能访问结构体的**导出字段**（首字母大写），type User struct { name string } 里的 name 永远是空——不是 bug，是 Go 反射机制限制。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 字段名必须大写：
Name string、CreatedAt time.Time - 不想改结构体定义？用 map[string]interface{} 中转，比如
map[string]interface{}{"name": u.name} - 时间字段常用
{{ .CreatedAt.Format "2006-01-02" }}，注意 Go 时间格式化字符串是固定魔术值，不是 POSIX 风格
生成代码缩进错乱？用 {{- }} 和 {{- }} 控制空白符
模板里换行和空格默认原样输出，导致生成的 Go 文件满屏空行或缩进塌陷，比如 if 块前后多出空行，go fmt 直接报错。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
{{- if .Cond }}吃掉前面的空白，{{ end -}}吃掉后面的换行 - 整段代码块外层套
{{- define "xxx" -}}，避免 define 指令本身引入额外空白 - 生成后跑一次
gofmt -w是兜底手段，但别依赖它修复逻辑级缩进问题
最麻烦的是嵌套循环+条件组合时空白符的叠加效应，这时候宁可拆成多个小模板 define，也别硬塞在一个文件里靠删空格调试。
