Go模板自定义函数必须在Parse前通过FuncMap静态注册，函数需首字母大写、签名严格匹配，否则静默失败或panic；返回template.HTML才能绕过HTML转义，多模板应共用根模板继承FuncMap。
Go 模板函数不是“学语法就能写”，而是要按模板引擎的运行时契约来设计——它不接受任意签名、不兼容闭包、不支持运行时注册。写错一个首字母或参数类型，Execute 时就静默失败或 panic。
funcmap 必须在 Parse 前注册，否则函数根本不可见
模板解析（Parse、ParseFiles、ParseGlob）会固化 AST，之后调用 Funcs() 对已解析的模板完全无效。
-
template.Must(template.New("t").Funcs(fm).ParseGlob("*.html"))✅ 链式调用确保注册早于解析 -
t := template.Must(template.ParseGlob("*.html")); t.Funcs(fm)❌ 注册失效，渲染时报function "xxx" not defined - 用
template.ParseFiles()（包级函数）返回新实例，无法再链式调用Funcs()，必须改用(*template.Template).ParseFiles()
函数必须首字母大写 + 签名严格匹配，小写函数会被静默忽略
Go 的 visibility 规则直接作用于模板函数：非导出函数即使塞进 template.FuncMap，也会被模板引擎跳过，不报错、不警告，只在渲染时报未定义。
- ✅ 正确：
func FormatTime(t time.Time) string（首字母大写，参数是time.Time，不是*time.Time或interface{}） - ❌ 错误：
func formatTime(t time.Time) string（小写，注册后无效果） - ❌ 危险：
func SafeSubstr(s interface{}, n int) string（interface{}入参看似灵活，但模板传nil或非string时 runtime panic）
返回 template.HTML 才能绕过 HTML 转义，string 不行
html/template 对所有字符串返回值默认做 HTML 转义。想输出原始 HTML（比如 Markdown 渲染结果），必须显式返回 template.HTML 类型，否则 <p> 会变成 <p></p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/gongju/2525" title="Go语言（Golang）1.26.0"><img
src="https://img.php.cn/upload/manual/001/589/237/6a6adeed24a4a355.png" alt="Go语言（Golang）1.26.0" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/gongju/2525" title="Go语言（Golang）1.26.0">Go语言（Golang）1.26.0</a>
<p>Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。</p>
</div>
<a href="/xiazai/gongju/2525" title="Go语言（Golang）1.26.0" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>。
立即学习“go语言免费学习笔记（深入）”；
- ✅ 安全绕过：
func RenderMD(s string) template.HTML { return template.HTML(markdown.Render(s)) } - ❌ 无效写法：
func RenderMD(s string) string { return markdown.Render(s) }（内容被双重转义） -
text/template不做自动转义，但也不提供template.HTML类型；混用html/template解析的模板和text/template的Execute会 panic
多模板共用函数时，别重复 New + Funcs，用根模板树继承
Funcs 是绑定到单个 *template.Template 实例的，不会跨实例共享。常见坑是主模板注册了 "datefmt"，子模板用 t.Lookup("sub.html") 加载后却报错。
- ✅ 正确：统一用
template.Must(template.New("base").Funcs(myFuncs).ParseGlob("templates/**.html"))，所有Lookup到的子模板都属于同一模板树，自动继承函数 - ❌ 错误：对每个文件单独
template.New().Funcs().ParseFiles()（性能差 + 函数不共享） - 克隆模板时需手动
t.Clone().Funcs(myFuncs)，Clone()不继承原实例的FuncMap
最易被忽略的是函数签名与模板传参的实际类型匹配——模板传进来的永远是反射解包后的具体值，不是接口或指针，哪怕结构体字段是 *string，模板里点出来的也是解引用后的 string。防御性检查得写在函数体内，而不是靠签名兜底。
