goframe通过显式设置gf_env环境变量或gf.env文件触发config-{env}.toml加载，优先级为gf.env＜gf_env，未设置时默认加载config.toml；加载时按key浅层覆盖，不合并嵌套结构。
Go 项目要实现多环境配置的差异化管理与自动切换，关键不在“写多少配置”，而在于「加载顺序是否可控」「覆盖逻辑是否可预期」「敏感项是否被环境变量兜底」。GoFrame、go-zero、Viper 这三类主流方案都支持命令行 > 环境变量 > 环境配置文件 > 默认配置的优先级链，但具体行为差异极大——稍不注意就会在生产环境加载了 dev 配置。
GoFrame 的 config-{env}.toml 加载机制怎么触发？
GoFrame 不靠环境变量自动识别环境，而是依赖 gf.env 文件或 GF_ENV 环境变量显式声明当前环境。它不会读取 APP_ENV 或 ENV 这类通用变量。
- 必须设置
GF_ENV=prod（或dev/test），否则默认加载config.toml，不会 fallback 到 config-prod.toml -
gf.env文件需放在项目根目录，内容只有一行：prod，比环境变量优先级略低但更稳定（适合容器部署） - 若同时存在
config-prod.toml和config.toml，GoFrame 会先加载config.toml，再用config-prod.toml中同名 key 覆盖——不是合并嵌套结构，而是浅层 key 覆盖 - 数据库连接池大小这类数值型字段，如果
config-prod.toml没定义，就沿用config.toml里的值；但如果 prod 文件里写了pool_size = 0，那它就是 0，不会跳过
go-zero 的 -f 参数和环境变量谁生效？
go-zero 启动时用 -f 显式指定配置文件（如 etc/greet-api.prod.yaml），此时环境变量和其它配置源全部失效——-f 是最高优先级，且不支持多文件叠加加载。
- 如果你写了
go run main.go -f etc/greet-api.dev.yaml，哪怕设置了REDIS_ADDR=xxx，也不会被读取 - 想让环境变量起作用，必须去掉
-f，改用GO_ENV=prod+ 基础配置文件名（如greet-api.yaml），go-zero 才会按规则查找greet-api.prod.yaml并合并 - 结构体 tag 中的
optional字段，在-f模式下仍生效：未出现在 YAML 中的 optional 字段会用默认值；但非 optional 字段缺失会直接 panic - YAML 中的
inherit标签只对EtcdConf这类嵌套结构有效，不能跨文件继承；基础配置里的timeout: 2000不会被greet-api.prod.yaml中的timeout: 5000自动识别为“覆盖”，它只是普通字段赋值
Viper 的 AddConfigPath 和 SetConfigName 容易踩哪些坑？
Viper 的路径和名称组合极易因相对路径错误导致 Config File Not Found，尤其在 go run 和二进制运行时工作目录不同。
-
viper.AddConfigPath("./config")在go run main.go时找的是项目根目录下的config/，但打包成二进制后执行时，./config是当前 shell 所在路径，不是二进制所在目录 - 正确做法是用
filepath.Dir(os.Executable())获取二进制位置，再拼接config子目录；开发期可用os.Getenv("APP_ENV")动态设SetConfigName("config." + env) -
viper.AutomaticEnv()默认把.替换为_，所以database.host对应环境变量DATABASE_HOST；但如果你手动调用viper.BindEnv("database.host", "DB_HOST")，那就以绑定为准 - 热重载
viper.WatchConfig()只监听单个文件，不支持监听整个目录或多个配置文件；且无法感知config.dev.yaml→config.prod.yaml的切换，只能 reload 当前已加载的那个文件
生产部署时最常被忽略的配置安全点
所有框架都允许用环境变量覆盖配置，但真正上线时，90% 的事故源于「以为覆盖了，其实没生效」。
- 容器中启动命令写成
./app -f etc/app.prod.yaml，却在env:里加了DB_PASS=xxx——该变量完全被忽略，因为-f关闭了环境变量加载 - GoFrame 的
GF_ENV必须在进程启动前注入，Dockerfile 中用ENV GF_ENV=prod有效，但docker run -e GF_ENV=prod也有效；而gf.env文件必须随二进制一起 COPY 进镜像，不能挂载空文件 - go-zero 的
redis.RedisKeyConf结构体里，Addr字段带json:",optional"，但Password没标optional——意味着 prod YAML 里没写password就会 panic，而不是 fallback 到环境变量 - Viper 的
viper.Get("database.password")返回空字符串，不等于没设置；要用viper.IsSet("database.password")判断是否存在，否则可能把空密码当合法值传给 MySQL 驱动
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
