viper.AutomaticEnv() 默认排在源列表最后导致环境变量不生效，必须重置后按序调用 ReadInConfig、SetEnvPrefix、SetEnvKeyReplacer 再调 AutomaticEnv；多配置文件需手动 MergeConfig 实现分层覆盖；避免 BindEnv 与 AutomaticEnv 混用；推荐用 mapstructure tag 结构体 Unmarshal 统一管理配置。
为什么 viper.AutomaticEnv() 加了却没生效
不是函数没调用，而是它注册的环境变量源默认排在所有源的最后——比 config.yaml 还低。所以文件里的 db.host 永远赢过 DB_HOST。
必须手动控制源顺序：
-
viper.Reset()清掉默认注册的源（尤其测试/热重载时容易漏） - 先
viper.ReadInConfig()加载文件（此时文件值已进内存） - 再
viper.SetEnvPrefix("APP")，否则DB_HOST会映射成host而不是db.host - 紧接着
viper.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))，让db.host→DB_HOST - 最后
viper.AutomaticEnv()—— 这时它才被加到源列表最前面
怎么让 config.yaml + config.prod.yaml + config.local.yaml 分层叠加
viper.ReadInConfig() 只找第一个匹配文件，不会自动合并。想实现「基础 → 环境 → 本地」三层覆盖，得自己按序 MergeConfig()：
- 用
os.ReadFile("config.yaml")读 base，viper.MergeConfig(bytes) - 再读
config.$ENV.yaml（如config.prod.yaml），再次MergeConfig() - 最后读
config.local.yaml（通常.gitignore掉），再MergeConfig() - 每一步都检查
err：文件不存在是常见错误，别假设它一定存在 - 嵌套结构（如
server）会递归合并，不是全量替换
viper.BindEnv("http.port", "HTTP_PORT") 和自动模式混用会冲突
手动 BindEnv() 是点对点绑定，一旦绑定了 http.port → HTTP_PORT，后续调用 AutomaticEnv() 就不再尝试自动映射这个 key。
立即学习“go语言免费学习笔记（深入）”；
Colly Golang Web Scraper and Crawler Framework
下载
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
但如果同时设了 viper.SetEnvPrefix("APP")，又没删掉旧绑定，就可能出现 APP_HTTP_PORT 和 HTTP_PORT 都被解析、结果不可控。
调试建议：
- 运行前调
viper.GetEnvVars()查当前所有已绑定映射，确认没有重复或遗漏 - 统一用自动模式（
SetEnvPrefix+AutomaticEnv）适合整套配置；只对极少数字段（如启动开关）用BindEnv - 避免在
init()里做任何绑定，否则单元测试无法注入 mock 环境变量
用 viper.Unmarshal() 代替一堆 viper.GetString()
直接写 viper.GetString("database.host") 把配置 schema 散落在各处，改字段名就得全局搜。正确做法是定义结构体，靠 tag 控制映射：
type Config struct {
DB DBConfig `mapstructure:"database"`
Server ServerConfig `mapstructure:"server"`
}
type DBConfig struct {
Host string `mapstructure:"host"`
Port int `mapstructure:"port"`
}
然后统一 viper.Unmarshal(&cfg)。注意：
- 必须用
mapstructuretag，不是json或yaml - 未设置的字段会保持零值，所以得提前
viper.SetDefault("database.port", 5432) - Unmarshal 后建议做字段校验（比如
cfg.DB.Host == ""就 panic），别等运行时炸
环境变量覆盖最终生效的关键不在“有没有调 AutomaticEnv”，而在“它是不是第一个被查的源”——这个顺序必须由你亲手控制，Viper 不会替你猜优先级。
