最稳妥的配置填充方式是直接用 os.Expand 或正则替换；os.Expand 适合单层环境变量替换，性能高且无模板开销，但仅支持 $KEY 和 ${KEY} 格式，未定义变量原样保留；正则替换更灵活，适用于 fallback、多数据源等场景；text/template 仅在需条件、循环、默认值等复杂逻辑时才引入。
直接用 os.Expand 或正则替换最稳妥，别一上来就上 text/template ——90% 的配置文件填充，三行代码搞定，且无模板解析开销。
用 os.Expand 做单层环境变量风格替换
适合填 ${DB_HOST}、$PORT 这类纯 key-value 映射，不涉及条件、嵌套或非环境数据源。它比正则快一个数量级，CLI 初始化常用。
- 回调函数签名必须是
func(string) string，查不到 key 时返回空字符串（别 panic），否则整串被截断 - 只支持
$KEY和${KEY}两种格式，{{.Key}}或${${ENV}_PORT}完全不识别 - 示例：
os.Expand("addr: ${HOST}:$PORT", func(key string) string { return os.Getenv(key) }) - 注意：它不会报错或警告缺失变量，原样保留占位符——调试时反而方便定位漏配项
用 regexp.ReplaceAllStringFunc 自定义解析逻辑
当你需要 fallback 默认值、从 map 取值、或支持非环境变量（如 YAML 配置字段）时，正则 + 回调是更可控的选择。
- 模式必须用非贪婪：
re := regexp.MustCompile(`\$\{([^}]+)\}`)，否则${A}${B}会被当做一个匹配 - 提取 key 推荐用
re.FindStringSubmatch([]byte(match))[2 : len(match)-1]，避免越界或空切片 panic - 未命中时返回原
match（而非空字符串），能暴露缺失 key，避免静默错误 - 别用
strings.ReplaceAll多次遍历——遇到嵌套占位符（如${DB_HOST}:${${PORT}}）会彻底失效
什么时候必须上 text/template？
只有当你需要条件判断（{{if .Debug}}）、循环（{{range .Endpoints}}）、默认值（{{.Timeout | default "30s"}}）或混合数据源（环境变量 + flag + 硬编码 map）时才值得引入。
立即学习“go语言免费学习笔记（深入）”；
- 模板必须传 struct 或 map，struct 字段名首字母必须大写（导出），否则
{{.host}}拿不到值 - 预编译模板：
t := template.Must(template.New("").Parse(tpl))，高频调用不编译会吃性能 -
template.ParseFiles路径基于可执行文件目录，不是当前工作目录——二进制移动后硬写"./config.tpl"必报"no such file or directory" - 安全提示：不要渲染不可信输入，哪怕
text/template不支持exec，逻辑泄露风险仍存在
真正容易被忽略的是热更新场景：如果配置文件要动态 reload，替换逻辑必须和数据加载解耦。用 atomic.Value 存 *configData 指针，新配置解析完再 Store，业务侧 Load() 拿快照——这样既无锁又不会在替换中途读到半截数据。
