Go标准模板不支持自定义引擎，只允许通过FuncMap注册函数、控制加载路径和注入上下文；函数须在Parse前注册，首字母大写，签名严格匹配，推荐用template.Must包裹；路径基于os.Getwd()，建议用embed.FS+ParseFS。
Go 语言标准模板（text/template 和 html/template）本身不支持“自定义模板引擎”，只支持在现有引擎上扩展行为——真正要做的，是注册函数、控制加载路径、注入上下文，而不是重写解析器。
自定义函数必须在 Parse 前用 Funcs 注册
模板里写的 {{.Price | formatMoney}} 或 {{now | dateFormat "2006-01-02"}}，背后全靠 FuncMap 提供。但这个映射表必须在调用 Parse 之前挂载，否则函数名在执行时直接被忽略，渲染结果为空或 panic。
- 函数必须首字母大写（Go 可导出规则），例如
FormatMoney✅，formatMoney❌ - 签名要严格匹配：模板传参是反射解包的，
func(string) string安全，func(interface{}) string极易因类型不匹配崩溃 - 别在函数里
panic—— 模板会吞掉 panic 并静默返回空字符串，很难定位问题；应做防御性检查，比如对nil字符串返回默认值 - 推荐用
template.Must(t.Funcs(fm).Parse(tpl))包裹，把注册和解析错误挡在启动阶段
模板文件路径不是按代码目录找的
template.ParseFiles("templates/index.tmpl") 的路径基准是进程当前工作目录（os.Getwd()），不是 main.go 所在位置。你在项目外执行 go run ./cmd/server，它就会去你终端所在的路径下找 templates/，而不是项目根目录。
- 开发期最稳方案：用
embed.FS+template.ParseFS，把模板打包进二进制，路径绝对可靠 - 手动拼路径可用
filepath.Join(filepath.Dir(runtime.Caller(0)), "templates", "index.tmpl")，但仅限单文件 - 避免用
ParseGlob("templates/*.tmpl")，它不报错也不提示“没匹配到”，容易误以为加载成功了
别试图手写模板解析器，扩展 FuncMap 就够了
有人想实现 Django 风格的 {% for %} 或 {{ value|default:"xxx" }}，结果发现标准库连管道符 | 都不认，直接 panic：“unexpected \"|\" in command”。这不是 bug，是设计如此。
立即学习“go语言免费学习笔记（深入）”；
- 标准库模板语法已高度优化，支持嵌套、作用域隔离、HTML 自动转义等，重写极易引入安全漏洞和作用域泄漏
- 真需要 Django 风格？换
pongo2，它纯 Go 实现、无 cgo、完整支持 filter 链和 block 继承 - 多数所谓“定制需求”，其实只是加几个业务函数：权限判断、i18n 翻译、时间格式化——这些全靠
FuncMap解决，无需碰解析逻辑 - 如果要隔离环境（如测试 vs 生产），用
t.Clone().Funcs(testFuncs)，比硬编码新引擎轻量得多
最容易被忽略的是：模板函数里的并发安全性。如果你在 FuncMap 里塞了一个闭包捕获了局部变量，又在多个 goroutine 里共用同一个 *template.Template 实例，就可能引发数据竞争——函数本身不是线程安全的容器，它只是被模板引擎调用的一段逻辑。
