Go项目构建报错：template/*.tmpl无匹配文件（已存在tmpl文件）

问题根源 #

• 目录大小写不匹配：项目中模板文件位于Web/template目录（大写W），但报错路径显示为web/render.go，在区分大小写的操作系统（Linux/macOS）中，Go会将web与Web判定为不同目录，导致路径查找失败。
• embed未指定嵌入范围：代码里的templateFS变量缺少//go:embed指令，Go无法识别需要嵌入哪些文件，自然找不到模板资源。
• 模板路径不完整：代码中使用的模板路径（如template/include/*.tmpl）未匹配实际文件的目录层级，或是缺少文件后缀。

修复步骤 #

1. 补充embed嵌入指令 #

在templateFS变量上方添加//go:embed指令，明确指定要嵌入的模板文件路径（路径相对于当前render.go所在的Web目录）：

//go:embed template/*.tmpl template/include/*.tmpl
var templateFS embed.FS

2. 统一目录大小写 #

确保代码中引用的目录名与实际目录名完全一致：

• 要么将Web目录重命名为web，与报错路径保持统一；
• 要么修改代码中所有涉及该目录的引用（如导入、路径字符串）为大写的Web。

3. 修正模板解析路径 #

调整模板解析的路径，确保与embed指令中的路径、实际文件后缀匹配：

func parseTmpl(name string) *template.Template {
   tmpl := template.New(name)
   tmpl = template.Must(template.ParseFS(templateFS, "template/include/*.tmpl"))
   // 补充.tmpl后缀，匹配实际文件名
   return template.Must(tmpl.ParseFS(templateFS, "template/"+name+".tmpl"))
}

验证 #

修改完成后，执行go build ./cmd/twit，即可正常构建项目，不会再出现模板文件找不到的报错。

内容的提问来源于stack exchange，提问作者Альнур Абдыкалыков