text/template 用于生成配置文件等文本，非环境搭建工具；需传入导出字段结构体、避免 nil 数据、用 parseglob 或 embed.fs 加载模板、{{-}} 控制空白、funcmap 注册函数。
text/template 不是用来搭建 Go 语言环境的，它不参与安装、PATH 配置、模块初始化或 IDE 设置。你不能用模板生成一个能运行 go run 的系统环境——那得靠 shell 脚本、手动配置或安装器完成。
但如果你已经搭好 Go 环境，想用 text/template 自动生成项目配置文件（比如 go.mod、.gitignore、Dockerfile、CI YAML），那就非常合适。下面说清楚怎么做、为什么这么干、容易栽在哪。
模板里写 {{.ModuleName}} 却报 “can’t evaluate field ModuleName”
这是最常卡住人的错误：你传了个 map[string]interface{}，却指望模板按结构体字段方式访问。
- 结构体字段必须首字母大写：
type Config struct { ModuleName string }✅；modulename string❌ - 别传
map[string]interface{}{"ModuleName": "myapp"}后写{{.ModuleName}}—— map 没“字段”，只有键；它其实能工作，但类型不安全、IDE 不提示、易拼错 - 更稳做法是定义结构体：
cfg := Config{ModuleName: "myapp"}，再传给t.Execute(w, cfg) - 调试时加一行
fmt.Printf("%#v\n", cfg)，确认字段名、大小写、嵌套层级都对
从文件加载模板总提示 “pattern matches no files”
不是模板写错了，是 template.ParseFiles() 的路径相对于 os.Getwd()，不是源码目录，也不是二进制所在目录。
- 运行
go run main.go时，工作目录通常是项目根；但打包成./app后，用户可能在任意路径下执行，templates/go.mod.tmpl就找不到了 - 改用
template.ParseGlob("templates/*.tmpl")更鲁棒，通配符自动匹配当前工作目录下的所有匹配文件 - 终极方案是用
embed.FS打包进二进制：import _ "embed"<br>//go:embed templates/*.tmpl<br>var tmplFS embed.FS<br>t := template.New("").ParseFS(tmplFS, "templates/*.tmpl") - 不确定当前工作目录？加一行
fmt.Println("cwd:", os.Getwd())看清再说
生成的 go.mod 或 Dockerfile 缩进混乱、空行爆炸
text/template 默认原样输出所有空白符——换行、缩进、空格全照搬。这不是 bug，是设计。你要的是“可读模板”，它只管“精确输出”。
- 用
{{- if .WithDB}}吞掉前面所有空白（包括换行），{{end -}}吞掉后面换行 - 避免无意义空行：循环前先判断
{{if .Dependencies}}，防止空切片时还留着require ...块 - 生成 Go 代码或 YAML 时，别靠模板缩进来对齐；逻辑压成单行更稳：
{{range .Imports}}import "{{.}}"{{end}} - 真要美观缩进的 JSON/YAML？别让模板干这事：
json.MarshalIndent(data, "", " ")先序列化好，再注入模板
想在模板里调用 strings.ToUpper 或自定义函数
text/template 默认不认任何函数，连标准库函数都要显式注册。
- 必须通过
FuncMap注册：t.Funcs(template.FuncMap{"upper": strings.ToUpper, "snake": toSnakeCase}) - 注册后才能用管道：
{{.ServiceName | upper}}；写{{upper .ServiceName}}也行，但风格不统一 - 函数签名必须是
func(interface{}) interface{}或带明确参数类型，否则template解析时 panic -
template.Must()要用在Parse阶段（如template.Must(t.Parse(...))），它会在解析失败时立刻 panic，省得等到Execute才暴露语法或函数未注册错误
复杂点在于：模板本身不解决环境搭建问题，它只负责把已知参数转成文本。真正容易被忽略的是——你传进去的数据结构是否导出、是否非 nil、是否和模板路径预期一致。这些细节不检查，模板就静默失败或 panic，而错误信息几乎不告诉你哪一层出了问题。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
