应选gopkg.in/yaml.v3：它最稳定、兼容性好、社区主流，支持锚点、别名、严格模式及精确错误定位；v2存在空值panic、嵌套解析bug，已归档；必须用导出字段+显式yaml标签，且传结构体指针解析。
Go 项目中用 Fiber 框架读 YAML 配置文件，得靠第三方库
Fiber 本身不提供 YAML 解析能力，它只处理 HTTP 请求响应；YAML 解析必须交由 Go 生态的库完成，最常用的是 gopkg.in/yaml.v3。你不能直接在 fiber.Ctx 或路由里调用某个 Fiber 内置函数去 load YAML——那根本不存在。
实际流程是：启动时用 yaml.Unmarshal 把文件内容解析进 Go 结构体，再把结构体实例传给 handler 或注入到依赖容器里。
- 别试图在每个请求里重复解析 YAML 文件（性能差、无缓存）
- 不要用
yaml.v2，v3 是当前稳定版，支持更多特性（如字段标签yaml:",omitempty"） - 确保配置文件路径是相对可执行文件的路径，不是相对于源码目录（常见坑：
os.Open("config.yaml")在 build 后找不到）
定义结构体时，字段名和 YAML key 的映射规则
Go 结构体字段必须首字母大写（导出），且需通过 yaml struct tag 显式声明对应关系。YAML 中的 user_name 默认不会自动映射到 UserName 字段——Go 没有自动蛇形转驼峰逻辑。
示例配置 config.yaml：
server: port: 8080 timeout: 30 database: host: "127.0.0.1" port: 5432 name: "myapp"
对应结构体写法：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
type Config struct {
Server ServerConfig `yaml:"server"`
Database DatabaseConfig `yaml:"database"`
}
type ServerConfig struct {
Port int `yaml:"port"`
Timeout int `yaml:"timeout"`
}
type DatabaseConfig struct {
Host string `yaml:"host"`
Port int `yaml:"port"`
Name string `yaml:"name"`
}
-
yaml:"port"必须显式写出，哪怕 key 和字段名一致 - 如果 YAML 里有
is_enabled: true，对应字段应为IsEnabled bool `yaml:"is_enabled"` - 嵌套层级越深，结构体嵌套也越深；不建议用
map[string]interface{}除非你真需要动态键
加载失败时常见的 panic 和静默错误
用 yaml.Unmarshal 时最容易忽略两点：一是没检查 error，二是把空指针或未初始化结构体传进去导致 panic。
- 错误写法：
yaml.Unmarshal(data, config)（config是 nil 指针 → panic） - 正确写法：
err := yaml.Unmarshal(data, &config)，且必须检查err != nil - YAML 中写了
port: abc，但结构体字段是int→ 解析失败，err非 nil，但字段值保持零值（0），容易误判为“成功” - YAML 缩进错位（比如用了 Tab 或同级空格数不一致）→ 解析直接失败，报
yaml: unmarshal errors
建议加一层封装，统一处理文件读取 + 解析 + 错误日志：
func LoadConfig(path string) (*Config, error) {
data, err := os.ReadFile(path)
if err != nil {
return nil, fmt.Errorf("read config file %s: %w", path, err)
}
var cfg Config
if err := yaml.Unmarshal(data, &cfg); err != nil {
return nil, fmt.Errorf("unmarshal config: %w", err)
}
return &cfg, nil
}
在 Fiber 应用中安全注入配置实例
不要把 *Config 当全局变量裸奔，尤其在并发 handler 中修改字段会引发竞态。推荐方式是：解析一次后，作为只读值传入 Fiber 的 App 上下文或自定义中间件闭包中。
- 避免：
var GlobalConfig *Config+ 全局修改 - 推荐：
app.Get("/health", healthHandler(cfg))，其中healthHandler是返回fiber.Handler的闭包 - 更规范的做法：用
fiber.App.Use(func(c fiber.Ctx) error { c.Locals("config", cfg); return c.Next() })注入，handler 内用c.Locals("config").(*Config)取用 - 注意
c.Locals是 request-scoped，线程安全，但别往里面塞可变大对象（比如 map 或 slice）
复杂点在于，YAML 配置往往含敏感字段（如密钥、数据库密码），这些值不应被日志打印或暴露在 debug 页面里——解析后立刻做 scrub，而不是等用的时候才检查。
