template.parsefiles找不到文件是因为路径基准是os.getwd()返回的当前工作目录，而非源码目录或二进制所在目录；必须用filepath.join等构造绝对路径或改用embed.fs。
template.ParseFiles 找不到文件？路径不是你想象的那样
Go 模板路径永远以 os.Getwd() 返回的当前工作目录为基准，不是源码目录、不是 go run 所在目录、也不是二进制所在目录（os.Executable() 只影响某些场景）。
- 运行时打印
fmt.Println("wd:", os.Getwd())是最快确认方式 -
template.ParseGlob("templates/*.html")比ParseFiles更容错，通配符自动匹配子目录 - 若模板在
templates/layout.html，必须写全路径：ParseFiles("templates/layout.html")，不能只写"layout.html" - Windows 下别硬写
\，统一用/或filepath.Join("templates", "base.html")
html/template 和 text/template 不能混着用
选错包是 90% 的“HTML 不渲染”“内容被转义成
”“JSON 输出非法”的根源。
- 渲染 HTML 页面，必须用
import "html/template"；否则{{.Content}}不会自动转义，XSS 风险拉满 - 但
html/template会把{、"、全部转义，所以<strong>绝不能用它生成 JSON/YAML/SQL</strong>——该切回 <code>text/template -
safeHTML函数只在html/template里有效：注册时写FuncMap{"safeHTML": func(s string) template.HTML { return template.HTML(s) }}，模板中写{{.RawHTML | safeHTML}}
结构体字段在模板里取不到？导出规则比你想的更严格
Go 模板不看 json: tag，只认首字母大写的导出字段。
-
UserName string✅ → 模板用{{.UserName}} -
user_name string❌ → 模板里完全不可见，也不报错，只是输出空 -
UserName string <code>json:"user_name"❌ → tag 不生效，仍得写{{.UserName}} - 嵌套访问如
{{.User.Profile.Avatar}}要求每一层都非 nil；任一层为 nil 就静默输出空，建议用{{with .User}}{{with .Profile}}{{.Avatar}}{{end}}{{end}}
Funcs 注册失败？顺序和签名一个都不能错
Funcs 必须在 Parse 或 ParseFiles 之前调用，AST 构建完就锁死了。
-
template.Must(template.ParseFiles("t.tmpl")).Funcs(f)❌ ——Funcs被忽略 -
template.Must(template.New("t").Funcs(f).ParseFiles("t.tmpl"))✅ - 自定义函数必须是导出的具名函数：
func Upper(s string) string✅，func(s string) string {...}❌（匿名函数不支持） - 参数类型必须严格匹配：模板传
{{upper .Name}}，那.Name运行时必须是string，传int或nil直接 panic - 函数名不能含点号：
"format.time"会在Parse阶段报unexpected . in identifier
嵌套模板没生效？名字大小写和调用方式要对齐
{{define "header"}} 定义的模板名是纯字符串匹配，不忽略空格、不忽略大小写、不自动补后缀。
- 定义了
{{define "header"}}，就得用t.ExecuteTemplate(w, "header", data) - 写成
"Header"、"header.html"、"_header"都会静默失败，输出空内容 -
Execute只执行根模板（即ParseFiles读入的第一个文件），不会自动展开{{define}}块；想用子模板，必须显式调用ExecuteTemplate
最常被跳过的细节：模板缓存没做，每次请求都重新 ParseFiles，CPU 白烧；还有 embed.FS 在 Go 1.16+ 后已是路径稳定的首选方案，不用再猜工作目录在哪。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
