os.Expand不支持嵌套，${${ENV}_PORT}不会展开，需手动分步处理；viper.AutomaticEnv()与模板替换无关，前者是配置源优先级机制，后者是对已加载字符串值的子串替换。
os.Expand 不支持嵌套，别指望 ${${ENV}_PORT} 能自动展开
Go 标准库的 os.Expand 只做一层字符串扫描，遇到 ${DB_HOST} 会提取出 "DB_HOST" 并传给回调函数；但遇到 ${${ENV}_PORT}，它根本不会识别内层 ${ENV}，而是把整个子串当作文本处理——最终返回原样或触发 panic（取决于回调逻辑）。这不是 bug，是设计使然。
常见错误现象：os.Expand("${${APP_ENV}_HOST}", os.Getenv) 返回 "${${APP_ENV}_HOST}"，而不是你期待的 "prod.example.com"。
- 必须手动分步展开：先取
APP_ENV值，拼出新 key（如"PROD_HOST"），再查一次环境变量 - 若配置字段本身含模板（如
url: "http://${DB_HOST}:${DB_PORT}"），需在解析后对结果再次调用os.Expand - 递归展开要加深度限制（建议 ≤3 层），避免无限循环或栈溢出
用 text/template 实现带逻辑的嵌套变量替换
真正需要嵌套、条件、拼接等能力时，text/template 是唯一可靠选择。它天然支持 {{.DB.HOST}}、{{.Env.APP_ENV | toUpper}}、{{if eq .Env.APP_ENV "prod"}}...{{end}} 等写法，且作用域清晰可推。
关键点在于数据结构组织：
立即学习“go语言免费学习笔记（深入）”；
- 把环境变量转成 map[string]interface{}（如
map[string]interface{}{"DB": map[string]string{"HOST": "127.0.0.1"}}）再传入Execute - 不要直接传
os.Environ()的扁平列表——那样无法支持.DB.HOST这类嵌套访问 - 若需复用已有 struct（如
Config），确保字段名首字母大写、tag 正确（yaml:"host"不影响 template，但结构体字段必须导出）
示例片段：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
t := template.Must(template.New("").Parse("port: {{.DB.PORT}}\nhost: {{.Env.DB_HOST | default \"localhost\"}}"))
data := map[string]interface{}{
"DB": map[string]string{"PORT": "5432"},
"Env": map[string]string{"DB_HOST": os.Getenv("DB_HOST")},
}
t.Execute(&buf, data)
viper 不提供嵌套模板展开，别混用 AutomaticEnv 和 ${key} 替换
viper.AutomaticEnv() 和 os.Expand(..., expandFunc) 解决的是完全不同的问题：前者让环境变量作为配置源参与键匹配（如 APP_DB_HOST → db.host），后者是在已加载的字符串值内部做子串替换（如 "${DB_HOST}:5432" → "127.0.0.1:5432"）。两者不叠加、不嵌套、不自动联动。
常见踩坑场景：
- 配置文件里写
url: "${DB_HOST}:5432"，却只调了viper.AutomaticEnv()—— 占位符原样保留 - 误以为
viper.GetString("db.url")会自动展开，其实它只返回原始字符串 - 对嵌套字段（如
server.tls.cert_path）直接调os.Expand(viper.GetString("server.tls.cert_path"), ...)，但该字段可能根本没被 viper 加载（因类型不匹配或路径错误）
正确做法：明确哪些字段需模板展开（例如字段名含 _template 或配置项标记 expand: true），然后单独取出、逐层 os.Expand 或交由 text/template 处理。
性能敏感场景下，避免在热路径反复编译 template
如果每秒要处理上千个配置字符串，用 text/template 每次都 template.New().Parse() 会显著拖慢性能：编译开销高、GC 压力大、且易逃逸。
实操建议：
- 将模板字符串硬编码或预加载为常量，启动时一次性
template.Must(template.Parse(...))编译并缓存 - 若模板来自用户输入（如 API 提交的 config snippet），必须加白名单校验 + context 超时（
ctx, _ := context.WithTimeout(ctx, 50*time.Millisecond)） - 简单占位符（仅
${KEY}）坚持用os.Expand：它无 GC、零分配、纳秒级延迟，比 template 快 10–100 倍
最易被忽略的一点：嵌套展开不是“功能越全越好”，而是“够用即止”。90% 的配置注入场景，两层 os.Expand 分步调用 + 显式 key 拼接，比引入完整 template 引擎更轻、更稳、更可控。
