在 Go 中读取 YAML 配置文件可以通过 gopkg.in/yaml.v3（推荐）或 sigs.k8s.io/yaml 等库实现。以下是 完整示例 和常见问题解决方案：
1. 安装依赖
go get gopkg.in/yaml.v3
2. 基础用法
(1) 定义配置结构体
type Config struct {
Server struct {
Host string `yaml:"host"` // 注意字段标签要和YAML键名一致
Port int `yaml:"port"`
} `yaml:"server"`
Debug bool `yaml:"debug"`
}
(2) YAML文件示例 (config.yml)
server:
host: "0.0.0.0"
port: 8080
debug: true
(3) 读取并解析
package main
import (
"fmt"
"os"
"gopkg.in/yaml.v3"
)
func main() {
// 读取文件内容
data, err := os.ReadFile("config.yml")
if err != nil {
panic(fmt.Errorf("read file failed: %w", err))
}
// 解析到结构体
var config Config
if err := yaml.Unmarshal(data, &config); err != nil {
panic(fmt.Errorf("parse yaml failed: %w", err))
}
fmt.Printf("Host: %s, Port: %d, Debug: %v\n",
config.Server.Host,
config.Server.Port,
config.Debug,
)
}
3. 高级场景
(1) 动态字段（任意键值对）
使用 map[string]interface{}：
var dynamicConfig map[string]interface{}
err := yaml.Unmarshal(data, &dynamicConfig)
(2) 多环境配置
通过环境变量指定文件路径：
env := os.Getenv("APP_ENV") // e.g., "dev", "prod"
filePath := fmt.Sprintf("config.%s.yml", env)
data, _ := os.ReadFile(filePath)
(3) YAML数组解析
servers:
- "host1:8080"
- "host2:9090"
对应结构体：
type Config struct {
Servers []string `yaml:"servers"`
}
4. FAQ（常见错误处理）
错误1：字段未导出（小写开头）
❌ 错误代码：
type config struct { // ← 结构体和字段必须大写开头才能被外部包访问！
host string
}
✅ 修复：
type Config struct {
Host string `yaml:"host"`
}
错误2：YAML缩进问题
❌ 错误YAML：
server:
host: "127.0.0.1" # ← host应与server同级缩进！
✅ 修复：
server:
host: "127.0.0.1" # ← 正确缩进（通常2或4空格）
5. Benchmark推荐库
| 库名称 | Star | 特点 |
|---|---|---|
gopkg.in/yaml.v3 |
★6k+ | Pure Go，稳定 |
sigs.k8s.io/yaml |
★1k+ | Kubernetes优化，支持JSON |
如果需要更复杂的功能（如合并多个YAML），可以尝试 koanf。
提供你的具体需求或YAML片段，我可以帮你进一步优化代码！
内容由零声教学AI助手提供，问题来源于学员提问
