Kratos配置必须在main()第一行显式调用conf.Load()并传入config.Provider，否则kratos.New()会因“no config provider registered”直接panic；文件路径需真实存在且可读，环境变量须手动拼接，结构体字段需首字母大写并正确打yaml tag。
Kratos 的配置必须显式加载，不写 conf.Load() 就 panic，不是报错而是直接崩溃。
conf.Load() 必须在 main() 第一行调用
它不是可选初始化步骤，而是 Kratos 启动前的强制前置动作。一旦延迟到日志、flag 或其他组件之后执行，kratos.New() 内部会因找不到 config.Provider 而 panic，错误信息极简（如 no config provider registered），毫无路径或上下文提示。
-
conf.Load()需要显式传入至少一个config.Provider，例如config.NewFile("configs/app.yaml")；环境变量CONFIG_PATH不会被自动读取，得手动拼进去 - 如果
configs/app.yaml不存在，c.Load()会返回 error，必须检查，否则后续 panic 更难定位 - 不要在
conf.Load()前初始化 logger 或依赖配置的组件——它本身可能要用到 logger，但此时还没 ready
配置源顺序决定覆盖优先级
Kratos 按 WithSource 的传入顺序合并配置，后加的 source 会覆盖前面同 key 的值。这不是“环境变量 > 文件”的固定规则，而是完全由你构造 config.New() 时的参数顺序控制。
- 推荐顺序（从低到高）：
config.NewFile("configs/default.yaml")→config.NewFile(fmt.Sprintf("configs/%s.yaml", os.Getenv("KRATOS_ENV")))→env.NewSource() - 多个 YAML 文件根 key 不能重复，否则会被后加载的覆盖；层级内字段可安全合并（如
server.port和database.url互不影响） - 环境变量源（
env.NewSource()）默认只读大写 + 下划线命名，比如SERVER_PORT=8000对应配置项server.port
Scan() 绑定结构体前必须确保 Load() 成功
Scan(&v) 不是“读取配置”，而是把已加载进内存的完整配置树，按字段名映射到 Go 结构体。它不触发任何 IO，失败只因结构体字段名/类型与配置内容不匹配，或 Load() 根本没执行。
- 结构体字段必须是 exported（首字母大写），且 tag 中指定正确路径，例如
Port int `yaml:"port"` - 嵌套结构体需对应 YAML 层级，
type Server struct { Port int `yaml:"port"` }要求配置里有server: { port: 8000 } - 别在
Scan()后再改配置源——它只读取当前内存快照，热更新需配合Watch()和自定义回调
常见配置文件路径和格式陷阱
内置 file.NewSource() 依赖文件后缀识别格式，但容易栽在路径拼接和权限上。它不递归扫描，也不自动 fallback 到其他扩展名。
- 路径必须是相对或绝对有效路径，
"configs"是目录，"configs/app.yaml"才是文件；传目录会报no such file or directory - 支持
.yaml、.yml、.json、.toml、.xml、.proto，但.yml和.yaml视为同一格式，不要混用 - YAML 中禁止 tab 缩进，必须用空格；布尔值写
true/false，别写True或YES，否则解析为字符串
真正卡住人的从来不是语法，而是 conf.Load() 没在第一行、文件路径写错、或者结构体 tag 拼错了小写字母——这些地方一错，Kratos 就静默 panic，连日志都来不及打。
