使用 viper 库管理多环境配置，支持 YAML 等格式并结合环境变量切换；2. 通过 APP_ENV 指定环境，加载对应 config.{env}.yaml 文件；3. 支持环境变量覆盖配置项，如 DATABASE_DSN；4. 将配置映射到结构体实现类型安全。
在云原生开发中，Golang项目常需支持多种运行环境（如开发、测试、预发布、生产）。良好的多环境配置管理能提升部署灵活性和系统可维护性。下面介绍一种简洁、实用的多环境配置方案。
使用 viper 管理配置文件
viper 是 Go 中广泛使用的配置管理库，支持 JSON、YAML、TOML 等格式，并能自动读取环境变量和命令行参数，非常适合多环境场景。
安装 viper：
go get github.com/spf13/viper创建不同环境的配置文件，例如：
立即学习“go语言免费学习笔记（深入）”；
- config.dev.yaml（开发环境）
- config.test.yaml（测试环境）
- config.prod.yaml（生产环境）
以 YAML 格式为例：
env: devserver:
port: 8080
database:
dsn: "user:pass@tcp(localhost:3306)/dev_db"
通过环境变量切换配置
程序启动时，根据环境变量 APP_ENV 加载对应配置文件。
示例代码：
package main
import (
"fmt"
"log"
"os"
"github.com/spf13/viper"
)
func main() {
env := os.Getenv("APP_ENV")
if env == "" {
env = "dev" // 默认为开发环境
}
viper.SetConfigName("config." + env)
viper.SetConfigType("yaml")
viper.AddConfigPath(".")
viper.AddConfigPath("./config")
if err := viper.ReadInConfig(); err != nil {
log.Fatalf("无法读取配置文件: %v", err)
}
fmt.Printf("当前环境: %s\n", viper.GetString("env"))
fmt.Printf("服务端口: %d\n", viper.GetInt("server.port"))
}
结合环境变量覆盖配置
viper 支持自动读取环境变量，可用于微调配置而无需修改文件。
例如，在生产环境中通过环境变量设置数据库密码：
export APP_ENV=prodexport DATABASE_DSN="user:securepass@tcp(db-prod:3306)/prod_db"
在代码中启用环境变量绑定：
viper.AutomaticEnv() // 允许读取环境变量viper.BindEnv("database.dsn") // 绑定特定字段
这样即使配置文件中写了默认 DSN，也会被环境变量覆盖，适合 CI/CD 流水线使用。
结构体映射与类型安全
将配置加载到结构体中，提高代码可读性和类型安全性。
type Config struct {Env string `mapstructure:"env"`
Server Server `mapstructure:"server"`
Database DB `mapstructure:"database"`
}
type Server struct {
Port int `mapstructure:"port"`
}
type DB struct {
DSN string `mapstructure:"dsn"`
}
var Cfg Config
func loadConfig() error {
return viper.Unmarshal(&Cfg)
}
调用 loadConfig() 后即可全局访问 Cfg.Server.Port 等字段。
基本上就这些。合理使用 viper 配合环境变量，能让 Golang 服务轻松适应云原生多环境部署需求，既保持配置清晰，又具备足够的灵活性。
