自定义函数必须在parse前注册且返回template.html才能输出原始html；函数名需大写、参数显式传递、类型受限；避免重复parse，生产环境不支持热重载。
自定义函数必须在 Parse 前注册，否则模板里调用会报 function "xxx" not defined；返回 template.HTML 才能绕过转义，直接输出原始 HTML。
注册顺序错：Funcs 必须在 Parse 之前调用
模板对象一旦完成解析（Parse、ParseFiles 或 ParseGlob），函数表就冻结了。之后再调用 Funcs 完全无效。
-
template.New("t").Funcs(myFuncs).Parse("{{foo}}")✅ 正确：注册早于解析 -
t := template.Must(template.ParseFiles("a.html")); t.Funcs(myFuncs)❌ 无效：此时已解析完毕 - 常见错误现象：
template: a.html: function "foo" not defined，八成是漏注册或顺序反了
html/template 中返回原始 HTML：必须用 template.HTML 类型
html/template 默认对所有字符串输出做 HTML 转义，这是安全机制，但也是你“看不到标签”的原因。
- 错误写法：
"md": func(s string) string { return "<p>hello</p><div class="aritcle_card flexRow artxards"> <div class="artcardd flexRow"> <a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill8272" title="anything-to-html"><img src="https://img.php.cn/upload/skill/000/000/081/179195588450431.jpg" alt="anything-to-html" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a> <div class="aritcle_card_info flexColumn"> <a rel="nofollow" href="/xiazai/skill8272" title="anything-to-html" class="overflowclass">anything-to-html</a> <p class="overflowclass">将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。</p> </div> <a rel="nofollow" href="/xiazai/skill8272" title="anything-to-html" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a> </div> </div>" }→ 模板里输出的是<p>hello</p> - 正确写法：
"md": func(s string) template.HTML { return template.HTML("<p>hello</p>") }→ 输出原生<p>hello</p> - 别忘了导入：
import "html/template"，否则template.HTML无法识别
函数签名和参数传递的硬约束
Go 模板不支持隐式上下文，函数不能自动拿到 . 或 $，所有依赖都得显式传参；同时签名必须导出且类型受限。
- 函数名必须首字母大写（如
FormatDate），小写函数注册后也无法被模板识别 - 参数/返回值只能是基础类型（
string、int、bool）、time.Time、指针或接口，不能是未导出结构体字段 - 若函数需访问配置或 DB 句柄，建议用闭包封装：
func(db *sql.DB) func(string) string { return func(id string) string { ... } } - 模板中调用必须带全参数：
{{formatDate .CreatedAt "2006-01-02"}}，不能省略.CreatedAt
性能陷阱：函数本身不慢，重复 Parse 才真拖垮服务
自定义函数执行开销极小，真正卡住响应的是每次请求都重新 ParseFiles —— 磁盘读 + 语法分析 + AST 构建三重负担。
- 正确做法：启动时一次性
template.Must(template.ParseGlob("templates/**/*.html"))，全局复用 - 动态选模板？用
tpl.Lookup("post.html")，不是重新ParseFiles - 函数里禁止阻塞操作：HTTP 请求、DB 查询、sleep 都会让整个 HTTP handler 同步等待
- 开发期可监听文件变更热重载，但生产环境不推荐——截至 2026 年 6 月，
html/template仍不支持热重载，改了模板必须重启进程
最容易被忽略的一点：同一个 FuncMap 不能混用于 html/template 和 text/template。前者要求安全输出，后者不做转义，类型错配可能引入 XSS 或乱码，注册前务必确认模板类型。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
