template.ParseFiles 报“no such file or directory”因默认从当前工作目录（非.go文件所在目录）读取模板；应使用ParseGlob、显式拼接路径或ParseFS（embed.FS场景）。
template.ParseFiles 为什么总报 "no such file or directory"
路径问题是最常见的拦路虎。Go 的 template.ParseFiles 默认从**当前工作目录**（不是源文件所在目录）读取模板，而很多人误以为它会相对于 .go 文件位置查找。
- 用
os.Getwd()打印当前工作目录，确认是否符合预期 - 推荐改用
template.ParseGlob("templates/*.tmpl")，更可控；或显式拼接路径：filepath.Join(filepath.Dir(runtime.Caller(0)), "templates", "index.tmpl") - 如果模板在嵌入的
embed.FS中（Go 1.16+），必须用template.ParseFS，ParseFiles完全不支持
如何安全地渲染 HTML 而不被 XSS 攻击
text/template 默认对 . 插值做 HTML 转义，但这个行为高度依赖变量的类型和标注方式，稍不注意就失效。
- 原始字符串（
string）会被自动转义；但若类型是template.HTML，则跳过转义——这是有意绕过防护的机制，务必只用于你完全信任的内容 - 不要用
{{ printf "%s" .Content }}，这会把内容转成普通string再输出，失去上下文感知；应直接写{{ .Content }} - 需要动态拼接 HTML 时，先构建
template.HTML值：template.HTML("" + content + "")，而不是在模板里用printf拼
template.FuncMap 注册函数后为什么调用时报 "wrong number of args"
自定义函数签名必须严格匹配，且 Go 函数返回值数量、类型需与模板中使用方式一致。常见错误是忽略 error 返回或多传参数。
Python v2.4 中文手册 chm
下载
Python v2.4版chm格式的中文手册，内容丰富全面，不但是一本手册，你完全可以把她作为一本Python的入门教程，教你如何使用Python解释器、流程控制、数据结构、模板、输入和输出、错误和异常、类和标准库详解等方面的知识技巧。同时后附的手册可以方便你的查询。
- 函数定义为
func(string) string，模板中写{{ title .Name }}是 OK 的；但如果函数是func(string) (string, error)，就必须在模板中用{{ $v, $err := title .Name }}或配合if判断错误 - 注册时未将函数地址传入：
t.Funcs(template.FuncMap{"title": titleFunc})，漏掉titleFunc变量名（不是字符串）会导致静默失败 - 函数名首字母小写（如
safeURL）在 FuncMap 中可注册成功，但在模板中无法调用——Go 模板只认首字母大写的导出函数
嵌套 template 时 define / template 指令为何找不到被调用的模板
模板作用域是线性的：只有在同一个 *template.Template 实例中 define 的名字，才能被同实例的 template 调用。跨文件、跨 Parse 就断开了。
立即学习“go语言免费学习笔记（深入）”；
- 多个文件要用
template.New("").ParseFiles("a.tmpl", "b.tmpl")，确保它们被加载进同一个根模板；单独template.ParseFiles("a.tmpl")再ParseFiles("b.tmpl")会创建两个独立实例 -
define必须出现在template调用之前（顺序敏感），且名字区分大小写 - 想复用模板片段又不想耦合，更稳妥的做法是把公共部分抽成独立
*template.Template，用Clone()+Funcs()组合，而不是强依赖define
