Go template.ParseFiles 为什么模板名不是文件路径

Go 的 template.ParseFiles 用文件基础名命名文件模板：读取 views/page.tmpl 后，默认名称是 page.tmpl。目录负责找到文件，模板名负责在已解析的集合里选择内容。因此 ExecuteTemplate 应传 page.tmpl；如果文件中另有 define，则可以用该显式定义的名称。

官方文档地址：https://pkg.go.dev/text/template

先用基础文件名指定入口

最小修正是保留 ParseFiles 的路径参数，把 ExecuteTemplate 的名称参数改成基础文件名。这里两个参数虽然都长得像字符串，却分别属于文件系统和模板集合。ExecuteTemplate 不会再次打开磁盘文件，也不会自动把传入的路径转换成基础名。

准备两个模板文件

在项目工作目录建立 views 文件夹，保存下面两个文件。page.tmpl 的正文引用 part.tmpl，名称与文件扩展名都要保留。示例使用 text/template 生成纯文本；生成 HTML 页面时使用 html/template，其 ParseFiles 命名方式相同。

views/page.tmpl：

{{/* 页面正文引用同一集合中的片段，并传递当前数据。 */}}
欢迎，{{.Name}}！
{{template "part.tmpl" .}}

views/part.tmpl：

{{/* 片段读取上层传入的数据对象。 */}}
当前姓名：{{.Name}}

main.go：

package main

import (
    "bytes"
    "fmt"
    "log"
    "text/template"
)

func main() {
    // 读取路径保留目录，执行入口使用文件的基础名。
    t, err := template.ParseFiles("views/page.tmpl", "views/part.tmpl")
    if err != nil {
        log.Fatal(err)
    }
    data := struct{ Name string }{Name: "读者"}
    var out bytes.Buffer
    // 先渲染到缓冲区，避免执行错误时把半截内容直接交给调用方。
    if err := t.ExecuteTemplate(&out, "page.tmpl", data); err != nil {
        log.Fatal(err)
    }
    fmt.Print(out.String())
}

在包含 main.go 和 views 的目录执行：

# 从项目目录读取相对路径，并运行文本渲染示例。
go run main.go

预期正文包含欢迎语和当前姓名。文件里的换行会参与文本输出。这里给出的是读者可自行运行的示例，插图只解释对象关系。

理解 Execute 与命名根模板

包级 ParseFiles 返回的对象以第一个文件的基础名作为名称。在上述顺序中，直接调用 Execute 会选择 page.tmpl；把 part.tmpl 放在第一个位置后，Execute 的默认入口也随之改变。多页面项目通常直接使用 ExecuteTemplate 指定入口，以免依赖文件顺序。

另一个容易混淆的写法是先 New 一个根对象，再调用它的 ParseFiles 方法：

// 此段替换前例的解析语句，后续仍使用 ExecuteTemplate 选择 page.tmpl。
t, err := template.New("bundle").ParseFiles("views/page.tmpl", "views/part.tmpl")
if err != nil {
    log.Fatal(err)
}

bundle 是创建时给根对象的名称。若此前没有为 bundle 提供正文，加载这两个文件也不会自动把 page.tmpl 的正文改名为 bundle。此时直接 Execute 可能因根模板没有内容而失败，明确执行 page.tmpl 则不依赖根对象是否有正文。

用 define 固定页面名称

如果希望页面入口不随文件改名而变化，可以把 page.tmpl 改成显式定义。定义名是完整字符串，不会自动取文件基础名，也不会自动增加扩展名。

{{/* 显式命名页面入口；文件名和页面名可以独立调整。 */}}
{{define "page"}}欢迎，{{.Name}}！
{{template "part.tmpl" .}}{{end}}

然后在主程序中把 ExecuteTemplate 的第二个参数改为 page。定义内部的内容属于 page，而文件模板 page.tmpl 只剩定义外的内容；仅有空白时，执行文件模板可能得到空白。应该把“解析成功”和“入口选对”分开理解。

需要排查名称时，可在开发代码里用 DefinedTemplates 查看集合描述，或者用 Lookup 查询具体名称。诊断完成后移除临时输出即可，避免给正常渲染结果夹带调试信息。

处理同名文件和常见疑问

不同目录的同名文件能否同时按路径执行？不能依靠目录区分默认模板名。例如 alpha/item.tmpl 和 beta/item.tmpl 的基础名相同；官方文档规定，这类文件名冲突按参数中最后出现的文件处理。想分别保留两套页面，可建立独立模板集合，或调整文件名及显式定义名。

改成绝对路径能否解决模板找不到？绝对路径可以解决读取阶段的工作目录问题，但不会改变默认模板名。要先区分错误来自 ParseFiles，还是来自 ExecuteTemplate。

html/template 也要去掉目录吗？其 ParseFiles 同样按基础名建立文件模板；生成网页时仍应使用 html/template 提供的上下文转义能力。这里讨论的名称规则不要求为了命名问题切换模板包。

实际使用时，先处理解析错误，再选择集合中确实存在的入口；单文件可用基础名，多页面可用稳定且唯一的 define 名。目录解决文件位置，名称解决模板选择。

参考：Go text/template ParseFiles；Go html/template ParseFiles。