template.ParseFiles 读不到文件是因为路径相对于工作目录而非源文件，需用os.Getwd()确认路径，推荐ParseGlob或ParseFS；Execute时panic因map未初始化；HTML转义需用template.HTML类型；模板引用失败因未统一解析到同一模板树。
template.ParseFiles 读不到文件？检查工作目录和路径写法
Go 的 template.ParseFiles 是相对路径，不是相对于源文件，而是相对于当前进程的工作目录（os.Getwd() 返回的路径）。很多人把模板放在 templates/ 下，却在项目根目录外执行命令，导致报错 open templates/index.html: no such file or directory。
- 用
os.Getwd()打印当前工作目录，确认是不是你预期的位置 - 推荐改用
template.ParseGlob("templates/*.html")，更灵活；或用io/fs+template.ParseFS（Go 1.16+），支持嵌入和绝对路径控制 - 如果必须用
ParseFiles，传入完整路径：比如filepath.Join("templates", "index.html")，再确保该路径在运行时存在
执行 template.Execute 时 panic: "assignment to entry in nil map"？检查数据结构初始化
这个 panic 不是模板语法问题，而是传给 Execute 的数据里有未初始化的 map 字段。比如结构体字段是 map[string]string 类型，但没做 make，模板里一访问 .Config["host"] 就崩。
- 模板里对 map、slice、指针的任意取值操作，都要求底层值已初始化——Go 不会自动帮你
make或new - 常见场景：HTTP handler 中构造响应数据时，漏掉
user.Roles = make(map[string]bool) - 调试技巧：在
Execute前加fmt.Printf("%+v", data)，看哪些字段是nil
HTML 特殊字符被转义太多？用 template.HTML 或 safeJS 等类型绕过自动转义
html/template 默认对所有 .Content 插值做 HTML 转义，这是安全设计，但有时你要渲染真实 HTML 片段（比如富文本后台返回的 <strong>高亮</strong>），直接插进去就变成纯文本了。
- 正确做法：把字符串转成
template.HTML类型，例如data.Content = template.HTML(rawHTML) - 别用
strings.ReplaceAll手动去转义，那只是表面“看起来对”，实际破坏了模板的安全边界 - 注意：仅限你完全信任该内容来源；用户输入的内容绝不能直接转
template.HTML - 其他类似类型还有
template.JS、template.CSS，对应不同上下文的转义规则
多个模板互相引用（define / template）时找不到 name？注意 Parse 和 Execute 的作用域
用 {{define "header"}}...{{end}} 定义块，再用 {{template "header" .}} 调用，结果报错 template: "header" is not defined，大概率是因为：模板没被同一个 *template.Template 实例解析过。
立即学习“go语言免费学习笔记（深入）”；
-
ParseFiles或ParseGlob返回的新模板实例，不会自动合并已有模板；每次调用都生成独立实例 - 正确方式：用
template.New("main").Funcs(...).ParseFiles(...)创建主模板，再用template.Must(t.New("sub").ParseFiles(...))显式挂载子模板 - 或者统一用
ParseGlob("templates/**/*.html")，让所有文件在一次解析中加载进同一模板树
跨包复用模板时，最容易忽略的是模板名冲突和解析时机——Parse 必须在 Execute 之前完成，且所有依赖模板必须在同一模板树里注册。
