90%的模板问题出在路径不匹配、html未正确转义、字段未导出或execute未检查error；parsefiles按os.getwd()路径查找，推荐embed.fs或filepath.join动态拼路径，html/template需用safehtml标记可信html，字段名须首字母大写。
Go 框架里模板渲染出不来界面？大概率不是代码写错了，而是路径、转义、字段可见性或执行目标没对上。
template.ParseFiles 找不到模板文件
报错 open index.html: no such file or directory 是最常见卡点。Go 不按代码位置或项目根目录找文件，而是以 os.Getwd() 返回的当前工作目录为基准——你在终端哪个路径下 go run main.go，它就从哪开始找。
- 调试时先加一行
fmt.Println("cwd:", os.Getwd())确认实际路径 - 用
filepath.Join(filepath.Dir(runtime.Caller(0)), "templates/index.html")拼出相对于源文件的绝对路径再传给ParseFiles - 更推荐 Go 1.16+ 的方案：把模板文件 embed 进二进制，用
template.ParseFS(embed.FS, "templates/*.html")，彻底规避路径问题
HTML 标签被当成纯文本显示
比如模板里写 {{.Content}}，但页面只看到 <p>Hello</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" 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 rel="nofollow" href="/xiazai/gongju/2525" title="Go语言（Golang）1.26.0" class="overflowclass">Go语言（Golang）1.26.0</a>
<p class="overflowclass">Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2525" title="Go语言（Golang）1.26.0" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div> 而不是渲染后的段落。这不是 bug，是 html/template 的默认保护机制在起作用。
- 确认你 import 的是
"html/template"，不是"text/template"；后者不转义，但也不安全 - 可信的 HTML 内容必须显式标记：
{{.Content | safeHTML}}（注意大小写，safeHTML是内置函数） - 别用
strings.ReplaceAll拼接 HTML 后塞进模板——这绕过转义，等于主动开后门 - 整个模板都不想转义？换包不现实，应检查是否真需要：富文本内容走
safeHTML，结构化内容（如按钮、表单）应由模板原生生成
结构体字段在模板里取不到值
定义了 type User { name string; Email string }，模板里 {{.name}} 报 panic：reflect.Value.Interface: cannot return value obtained from unexported field。
- Go 模板只能访问首字母大写的导出字段：
Name可以，name不行 - JSON tag（如
json:"name"）不影响模板可见性，字段名本身必须导出 - 临时调试可用
fmt.Printf("%#v", data)看反射实际能拿到什么 - 如果结构体来自第三方库且字段不可改，用
map[string]interface{}中转，或加 Getter 方法（如Name() string { return u.name }），模板里调{{.Name}}
ExecuteTemplate 名字不匹配导致空白输出
模板文件里写了 {{define "header"}}，但 tmpl.ExecuteTemplate(w, "Header", data) 或 "layout/header" 却没渲染任何内容——不会报错，只是静默失败。
- 模板名是严格字符串匹配，区分大小写、空格和斜杠
- 执行前用
tmpl.Templates()查看已加载的所有模板名，每个调.Name()确认拼写 - 嵌套模板建议统一用小写字母+下划线命名，比如
"base_layout"、"nav_bar"，避免大小写混淆 - 如果用
ParseGlob("templates/**/*.html")，注意通配符匹配的文件名会成为模板名（不含路径），templates/user/index.html的模板名就是"index.html"，不是"user/index.html"
真正容易被忽略的是：模板执行失败往往不 panic，而是返回 error 但被忽略——tmpl.Execute(w, data) 的 error 必须显式检查，否则界面白屏却找不到原因。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
