viper.readinconfig()报unknown config type，是因为viper无法自动识别无后缀、被strip后缀或embed.fs读取的字节流格式，必须在调用前显式设置viper.setconfigtype("yaml")等合法类型。
Go 没有内置的 Config 函数，所谓“Config 函数”只是开发者封装的加载逻辑，不是语言特性；直接调用 config.Load() 或类似写法前，必须明确它背后是 viper、yaml.v3+godotenv，还是自研解析器——选错底层，参数、错误、热更新行为全都不一样。
为什么 viper.ReadInConfig() 总报 unknown config type
这不是文件内容问题，而是 viper 无法从路径推断格式。尤其在以下场景：
- 文件名不带后缀（如
config）、或后缀被构建工具 strip（如 Bazel） - 用
embed.FS读取字节后调viper.ReadConfig(bytes.NewReader(data))，此时viper.SetConfigFile()完全失效 - 配置路径是符号链接，viper 查不到真实后缀
解决方法只有一条：在 viper.ReadInConfig() 前必须显式调用 viper.SetConfigType("yaml") 或 viper.SetConfigType("json")。别依赖自动识别。
结构体字段全是零值？先查导出和 tag
YAML/JSON 解析后字段没赋值，90% 是结构体定义问题，不是配置文件写错了：
- 字段首字母小写（如
port int）→ 不导出，yaml.Unmarshal直接跳过，不报错也不赋值 - tag 写成
yaml:"Port"，但 YAML 文件里是port: 8080→ 大小写不匹配，留零值 - 嵌套结构漏了外层 tag，例如
Server ServerConfig `yaml:"server"`忘了这个反引号部分 → 整个子结构不解析 - YAML 缩进用了 tab 而非空格 →
yaml.v3默认 panic，可加yaml.UnmarshalStrict捕获更明确错误
测试时 config.yaml 找不到？别改 os.Chdir()
go test ./pkg 的当前工作目录是 pkg/，不是项目根目录。相对路径 "config.yaml" 自然失败。
- 禁止在
init()里自动加载配置——会让测试和运行时行为不一致 - 禁止用
os.Chdir()切换路径——破坏并发安全，且容器中可能无权限 - 正确做法：把路径作为参数传入，例如
Load(configPath string) error - main.go 调
Load("config.yaml")，test.go 调Load("../config.yaml")或filepath.Join("..", "config.yaml")
热加载改了文件却没生效？三件事缺一不可
viper.WatchConfig() 只监听变更事件，不重读、不解析、不更新变量。常见静默失效原因：
- 回调里没调
viper.ReadInConfig()→ viper 内部缓存仍是旧内容 - 没调
viper.Unmarshal(&newCfg)→ 业务代码里的cfg.Port还是旧值 - 没用
atomic.Value或sync.RWMutex原子替换指针 → 并发读可能拿到“半更新”状态（如 Port 已变但 DBURL 还是旧的） - 监听路径写成目录（如
"./conf"）而非具体文件（如"./conf/app.yaml"）→ macOS 下易漏事件，编辑器保存常触发 rename 而非 write
最易被忽略的是：热更新后，所有业务代码必须通过 globalConf.Load().(*Config) 这种方式读取，不能缓存指针或字段副本——否则永远看不到新值。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
