text/template 的管道链不生效是因为函数未注册、类型不匹配或字段未导出；需手动注册如 title 函数，且函数签名须为 func(in T) U 或 func(in T) (U, error)，调用时用 if 处理错误。
text/template 中的管道链为什么有时不生效
管道（|）在 text/template 里不是万能的，它只对前一个表达式的求值结果做函数调用，且函数必须注册进模板函数映射中。没注册的函数、未导出字段、或类型不匹配都会让管道“静默失败”——模板照常渲染，但结果为空或报错。
常见错误现象：{{ .Name | title }} 渲染成空字符串，而 .Name 明明有值；或者报错 function "title" not defined。
-
title是html/template的内置函数，text/template默认没有，得自己注册：funcMap := template.FuncMap{"title": strings.Title} - 管道左侧必须是可求值表达式，
{{ . | title }}要求.是字符串类型，若传入结构体就会 panic - 函数签名必须是
func(in T) (out U, err error)或func(in T) U形式，多参数或无返回值都不行
如何安全地在模板里调用自定义函数并处理错误
Go 模板不支持 try/catch，但可以通过函数返回 (string, error) 配合 if 判断来规避 panic。
使用场景：格式化时间、解析 JSON 字段、URL 编码等可能出错的操作。
立即学习“go语言免费学习笔记（深入）”；
- 定义函数时返回
(string, error)，例如：urlEscape := func(s string) (string, error) { return url.PathEscape(s), nil } - 在模板中必须用
if包一层：{{ if $escaped, $err := .Path | urlEscape }}{{ $escaped }}{{ else }}[invalid]{{ end }} - 注意变量绑定语法：
$x, $y := ...是合法的，但不能写成:=后直接跟管道，必须用括号包裹整个调用
template.Execute 与 ExecuteTemplate 的关键区别
二者都触发渲染，但作用对象不同：前者渲染主模板（即 template.New 创建的那个），后者按名称查找并渲染已定义的子模板（{{ define "name" }}）。
容易踩的坑：用 Execute 渲染含 {{ template "xxx" }} 的模板时，如果没调用 ParseFiles 或 ParseGlob 加载所有依赖模板，会报错 template: "xxx" is undefined。
-
Execute(w, data)：只认当前模板树的根节点，不自动加载其他文件里的define -
ExecuteTemplate(w, "sub", data)：必须确保 “sub” 已通过Parse/ParseFiles注册到该模板实例中 - 推荐做法：统一用
template.ParseGlob("*.tmpl")加载全部，再调用ExecuteTemplate，避免漏定义
text/template 和 html/template 能否混用
不能直接混用。虽然两者 API 几乎一致，但底层的转义逻辑和函数注册表完全隔离。html/template 自动对 {{.}} 做 HTML 转义，text/template 不做任何转义——这是设计差异，不是 bug。
性能影响很小，但兼容性风险高：把 html/template 实例传给期望 text/template 的函数，类型不匹配会编译失败。
- 别试图类型断言转换：
t.(*html.Template)会 panic，因为html.Template不嵌入text.Template - 如果项目同时需要生成 HTML 和纯文本（如邮件正文 + 日志摘要），建议分开初始化两个模板实例，各自
FuncMap独立维护 - 函数名冲突不检查：你在
text/template里注册了js，又在html/template里注册同名函数，不会报错，但行为各自独立
模板里最麻烦的从来不是语法，而是函数注册时机和数据类型流动——漏注册、类型错位、子模板没加载，三者占了 80% 的实际报错。动手前先确认 template 实例是否真的“知道”你要用的那个函数。
