config

config 包负责配置加载、格式解析与初始化阶段的配置装配。它适合放在程序启动时,把文件内容读成结构体,再决定是否进入后续流程。

适合什么场景

  • 项目需要从文件加载配置,并兼容多种格式。
  • 想统一配置搜索顺序和解析入口。
  • 希望把“加载”和“校验”两个阶段拆开控制。

常用入口

  • config.LoadConfig:加载并执行校验。
  • config.LoadConfigSkipValidate:只加载,不做校验。
  • config.SetConfig:设置全局配置对象。
  • config.RegisterParser:注册额外解析器。

使用建议

  • 对外可变配置与启动必需配置,最好分层管理,不要都塞进一个超大结构体。
  • 如果配置必须合法才能启动,优先使用 LoadConfig 并结合 validator
  • 文档只保留“支持多格式”这一事实,不再宣传无法在当前仓库中验证的额外能力。

相关文档