go语言文件模板替换核心是：简单场景用os.expand（支持${key}格式，性能高）；复杂逻辑必须用text/template（需execute传结构体/map，字段须导出，路径基于可执行文件目录）。
Go 语言里做文件内容的模板替换，核心就两条路：轻量字符串替换用 os.Expand 或 strings.ReplaceAll；真要带逻辑（条件、循环、嵌套结构）就得上 text/template 或 html/template。别一上来就写模板引擎——90% 的配置文件填充，os.Expand 三行搞定。
用 os.Expand 做简单变量替换
适合填充配置文件、环境变量占位符（如 ${DB_HOST}），不涉及逻辑判断或数据结构遍历。
-
os.Expand只认${key}或$key格式，不支持{{.Key}} - 回调函数必须返回
string，查不到 key 时建议返回空字符串而非 panic - 不能嵌套（比如
${${ENV}_PORT}不会解析），也不处理转义 - 性能比
template高一个数量级，适合高频调用场景（如 CLI 工具初始化）
示例：
config := `host = ${DB_HOST}
port = ${DB_PORT}
debug = ${DEBUG}`
env := map[string]string{"DB_HOST": "127.0.0.1", "DB_PORT": "5432", "DEBUG": "true"}
result := os.Expand(config, func(k string) string { return env[k] })
用 text/template 渲染结构化数据
当你需要根据 struct 或 map 动态生成 HTML、Markdown、YAML 甚至 SQL 片段时，text/template 是标准解法。注意它不转义 HTML，html/template 才做自动转义。
- 必须用
Execute或ExecuteTemplate传入数据，不能直接传string或nil - 模板中
.是当前作用域，嵌套{{range}}时.指向当前元素，根数据要用$访问 - 字段名必须首字母大写（导出），否则模板访问不到；
map[string]interface{}更灵活但无编译期检查 - 解析失败（比如语法错误、文件不存在）会在
ParseFiles或ParseGlob阶段报错，不是执行时
常见错误现象：template: xxx:1:1: executing "xxx" at <.name>: can't evaluate field Name in type interface {}</.name> —— 通常因为传了 map[string]string 却在模板里写了 {{.Name}}（键名是 "Name"，但 map 的 key 是小写 "name"）
ParseFiles 路径错误怎么快速定位
template.ParseFiles 报 no such file or directory，99% 是路径相对于可执行文件位置，不是当前工作目录。
- 用
filepath.Join(filepath.Dir(os.Args[0]), "templates/config.tmpl")拼路径最稳 - 开发期加
log.Printf("loading template from: %s", path)确认实际路径 - Windows 下避免硬写
\，统一用filepath.Join - 构建后二进制移动过？检查文件是否被
go build -o打包进目录，还是得随二进制一起分发
临时验证法：把模板内容写死成字符串，用 template.New("").Parse(tplStr) 绕过文件读取，确认是路径问题还是模板语法问题。
安全写回原文件的最小可靠流程
模板渲染完内容，要写回原文件？别直接 os.WriteFile 覆盖——断电、权限失败都会丢原始配置。
- 先写到
filename + ".tmp"临时文件 - 再用
os.Rename原子替换（Linux/macOS 安全，Windows 需同分区） - 若需保留原文件权限或修改时间，用
os.Stat读取后调os.Chmod和os.Chtimes - 不要省略任意一步的 error 检查，尤其是
Rename在 Windows 上可能失败
真正容易被忽略的是：模板渲染本身不保证线程安全。如果多个 goroutine 并发调用同一个 *template.Template 实例的 Execute，没问题；但如果你在 Execute 过程中修改了传入的 struct 字段（比如 user.LastAccess = time.Now()），那就得自己加锁——模板不负责数据保护。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
