Golang 配置管理：使用 config 插件库

在 Go 语言中，管理应用配置有多种方式，包括环境变量、命令行参数和配置文件等。下面我将介绍如何使用流行的 config 插件库来统一管理这些配置源。

安装 config 库

首先安装 config 库：

go get github.com/olebedev/config

基本使用示例

package main

import (
	"fmt"
	"log"
	"os"

	"github.com/olebedev/config"
)

type AppConfig struct {
	Server struct {
		Host string `json:"host"`
		Port int    `json:"port"`
	} `json:"server"`
	Database struct {
		URL      string `json:"url"`
		Username string `json:"username"`
		Password string `json:"password"`
	} `json:"database"`
	Debug bool `json:"debug"`
}

func main() {
	// 1. 从默认配置文件加载
	cfg, err := config.ParseYamlFile("config.yaml")
	if err != nil {
		log.Printf("Warning: %v, using default config", err)
		
		// 创建默认配置
		cfg, err = config.ParseYaml(`
server:
  host: localhost
  port: 8080
database:
  url: localhost:5432
  username: postgres
  password: postgres
debug: false
`)
		if err != nil {
			log.Fatal(err)
		}
	}

	// 2. 从环境变量覆盖配置
	if host := os.Getenv("APP_SERVER_HOST"); host != "" {
		cfg.Set("server.host", host)
	}
	if port := os.Getenv("APP_SERVER_PORT"); port != "" {
		cfg.Set("server.port", port)
	}

	// 3. 解析到结构体
	var appConfig AppConfig
	if err := cfg.Unmarshal(&appConfig); err != nil {
		log.Fatal(err)
	}

	fmt.Printf("Final config: %+v\n", appConfig)
}

支持多配置源的高级用法

下面是一个更完整的示例，支持 JSON/YAML 配置文件、环境变量和命令行参数：

package main

import (
	"flag"
	"fmt"
	"log"
	"os"

	"github.com/olebedev/config"
)

func main() {
	// 定义命令行参数
	configFile := flag.String("config", "config.yaml", "Path to config file")
	debug := flag.Bool("debug", false, "Enable debug mode")
	port := flag.Int("port", 0, "Server port")
	flag.Parse()

	// 尝试加载配置文件
	cfg, err := config.ParseYamlFile(*configFile)
	if err != nil {
		log.Printf("Warning: %v, using default config", err)
		cfg, _ = config.ParseYaml("") // 创建空配置
	}

	// 环境变量覆盖
	if envHost := os.Getenv("APP_HOST"); envHost != "" {
		cfg.Set("server.host", envHost)
	}
	if envPort := os.Getenv("APP_PORT"); envPort != "" {
		cfg.Set("server.port", envPort)
	}

	// 命令行参数覆盖（最高优先级）
	if *port > 0 {
		cfg.Set("server.port", *port)
	}
	if *debug {
		cfg.Set("debug", true)
	}

	// 获取配置值
	host, _ := cfg.String("server.host")
	portVal, _ := cfg.Int("server.port")
	debugVal, _ := cfg.Bool("debug")

	fmt.Printf("Server will run on %s:%d, debug mode: %v\n", 
		host, portVal, debugVal)
}

配置优先级

通常配置源的优先级如下（从低到高）：

1. 默认值（代码中硬编码）
2. 配置文件（JSON/YAML）
3. 环境变量
4. 命令行参数

最佳实践

1. 配置文件模板：提供一个 config.yaml.example 文件作为模板
2. 环境变量命名：使用统一前缀如 APP_ 避免冲突
3. 敏感信息：不要将密码等敏感信息提交到版本控制
4. 配置验证：加载配置后验证必填项和格式

其他替代方案

除了 olebedev/config，还有其他流行的配置管理库：

1. Viper：功能最全，支持多种配置格式和环境变量
2. Koanf：轻量级，支持多种配置源和格式
3. Envconfig：专注于环境变量到结构体的映射

选择哪个库取决于你的具体需求，对于简单应用，olebedev/config 已经足够；对于复杂需求，Viper 可能是更好的选择。