text/template中管道链不生效是因为函数未注册、类型不匹配或字段未导出；title等函数需手动注册，签名须为func(in t) u或func(in t) (u, error)，且字段必须导出。
管道在 text/template 里不是语法糖，而是显式函数调用链；没注册、类型错、字段未导出，它就“假装没发生”——既不报错也不渲染，这是最常踩的坑。
为什么 {{ .Name | title }} 渲染出来是空的
因为 title 不是 text/template 的内置函数，它是 html/template 才带的。你直接写，模板会静默忽略管道右侧，只输出 .Name 的原始值（如果字段导出且非空）；但如果 .Name 是空或 title 调用失败，结果就是空字符串，毫无提示。
-
text/template默认只带len、print、printf、index等极少数函数，title、lower、urlquery全都不在其中 - 必须手动注册：
funcMap := template.FuncMap{"title": strings.Title}，再通过tmpl.Funcs(funcMap)绑定 -
strings.Title只接受string类型输入；若.Name是int或nil，管道会 panic（不是静默失败） - 结构体字段必须首字母大写（即导出），否则
.Name求值为<no value></no>，管道左侧无值，整个链失效
{{ . | myFunc }} 报 panic: reflect: Call using *T as type T
这是典型的函数签名不匹配：你注册的 myFunc 接收指针或接口，但管道传入的是值类型，或者反过来。Go 模板函数签名极其严格，只认两种形式：
-
func(in T) U—— 单入单出，无 error -
func(in T) (U, error)—— 单入双出，第二返回值必须是error
其他任何变体都会导致 panic，比如：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
func(in *string) string（接收指针，但传入的是值） -
func(in string) (string, string)（第二返回值不是error） -
func() string（无参数，不能用于管道） -
func(in string, extra int) string（多参数，管道只传一个）
修复方式：统一用值类型入参，并确保返回类型精确匹配。例如时间格式化函数应写成：func(t time.Time) string { return t.Format("2006-01-02") }。
如何在模板里安全调用可能出错的函数
text/template 没有异常捕获机制，一旦函数返回 error 且你没显式检查，就会 panic 并中断整个渲染。唯一可靠的方式是用 if + 多变量绑定语法提前解包。
- 函数必须返回
(string, error)形式，例如：urlEscape := func(s string) (string, error) { return url.PathEscape(s), nil } - 模板中不能直接写
{{ .Path | urlEscape }}，而要写：{{ if $escaped, $err := .Path | urlEscape }}{{ $escaped }}{{ else }}[invalid]{{ end }} -
$x, $y :=是合法的，但:=必须紧贴管道调用，不能换行或加空格；整个表达式需用括号包裹（虽然模板引擎实际不强制，但不加易读性差且易错） - 注意：如果函数返回
error为nil，if分支仍会进入else—— 因为nil在模板中被视作 false，所以逻辑是成立的
template.Execute 和 ExecuteTemplate 渲染结果一样吗
不一定。两者触发的不是同一个模板对象：Execute 渲染的是你调用 template.New 创建的主模板（即根模板），而 ExecuteTemplate 是按名称查找已定义的子模板（用 {{ define "name" }} 声明的），再渲染它。
- 如果你只 Parse 了一个模板字符串，没用
define，那ExecuteTemplate会报template: "xxx" is not defined - 如果主模板里嵌了
{{ template "header" }}，但没用tmpl.ParseFiles或多次Parse加载该子模板，ExecuteTemplate("header")同样失败 - 并发调用时，两个方法都可安全复用同一
*template.Template实例，但输出目标（io.Writer）必须互斥，否则内容会交错
真正容易被忽略的是：子模板的上下文（.）默认继承自调用它的位置，但可以用 {{ template "name" .Data }} 显式传参覆盖——这点和函数调用很像，但很多人写 {{ template "name" }} 就以为自动透传了全部数据，其实只是透传当前作用域的 .。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
