go服务应通过env环境变量动态加载config.env.yaml配置文件，主配置config.yaml存通用项，环境文件仅覆盖差异；需显式设env、校验key大小写与分隔符、避免镜像打包生产配置、统一共享config结构体并强制snake_case命名。
Go 服务如何读取不同环境的配置文件
Go 本身不内置环境变量驱动的配置加载机制，得靠自己组织逻辑。常见错误是硬编码 config.yaml 路径，或在代码里写死 if env == "prod" { ... }，导致构建产物不可移植、测试难模拟。
推荐做法：用环境变量 ENV 或 GO_ENV 控制配置文件名前缀，统一加载逻辑：
config.<code>ENV</code>.yaml → config.dev.yaml / config.prod.yaml
-
ENV值必须小写且只含字母数字（避免空格、下划线引发解析失败） - 主配置文件
config.yaml放通用项（如服务名、端口默认值），环境文件只覆盖差异字段 - 用
viper.ReadInConfig()前先调用viper.SetConfigName("config." + os.Getenv("ENV"))，再viper.AddConfigPath("./configs") - 若
ENV未设置，默认 fallback 到dev，但上线前必须显式声明，禁止依赖默认值
viper.Load() 后为什么 config.Get("db.host") 总是空
典型现象：配置文件明明有 db.host: "127.0.0.1"，但 config.Get("db.host") 返回 nil 或空字符串。根本原因是 viper 默认不自动展开嵌套键，且大小写敏感。
- YAML 中的
db:是 map，db.host是合法 key，但需确保调用viper.SetConfigType("yaml")在ReadInConfig()之前 - viper 默认用
.当分隔符，但若配置里用了-（如redis-url），就得手动viper.SetEnvKeyReplacer(strings.NewReplacer("-", "_")) - 检查是否误调了
viper.Unmarshal(&struct{})却没给 struct 字段加yaml:"db_host"tag，导致字段未绑定 - 调试时直接打印
viper.AllSettings()，确认 key 名是否带多余空格或大小写不一致（比如写了DB.Host却读db.host）
生产环境不能把 config.prod.yaml 打进 Docker 镜像
镜像一旦构建完成就该是环境无关的。把生产配置塞进镜像，等于把密码、地址等敏感信息固化，违反十二要素应用原则，也导致同一镜像无法复用于多集群。
立即学习“go语言免费学习笔记（深入）”；
- Dockerfile 里只 COPY 通用配置和
config.dev.yaml，config.prod.yaml通过docker run -v /path/to/config.prod.yaml:/app/configs/config.prod.yaml挂载 - Kubernetes 场景下，用
Secret或ConfigMap挂载，挂载路径仍为/app/configs/config.prod.yaml，保持路径一致 - 启动命令中必须显式传入
ENV=prod，不能依赖容器内默认环境变量，否则可能因 base image 预设值导致加载错文件 - 验证方式：进入容器执行
ls -l /app/configs/和echo $ENV，二者必须同时存在且匹配
微服务间配置结构不一致导致对接失败
多个 Go 微服务各自定义 Config struct，字段名、类型、默认值不统一，上游改个 timeout_ms 类型为 int64，下游还是 int，一解析就 panic。
- 所有服务共用一个 Go module（如
github.com/yourorg/config）导出统一type Config struct，各服务import它而非自己定义 - 配置项命名强制 snake_case（如
max_retries），避免MaxRetries和maxRetries混用；viper 自动转驼峰，但源头统一才可靠 - 对必填字段加
viper.GetXXX()后判空，比如if viper.GetString("redis.addr") == "" { log.Fatal("redis.addr required") } - CI 阶段跑一个校验脚本：用
yq提取所有config.*.yaml的 key 路径，比对是否都出现在公共 struct 的 yaml tag 里
环境切换真正卡点不在语法，而在配置生命周期管理——文件谁生成、谁分发、谁校验、谁销毁。漏掉任一环，ENV=prod 就只是个字符串。
