go项目中环境变量的配置

2,810 阅读3分钟

一、为什么要配置文件

  • 1、容易编辑,配置比较集中,方便修改,在大业务量的系统里面,通过配置会方便后人理解整个系统的架构
  • 2、做到业务代码和环境解耦,环境配置变量不侵入到代码层面
  • 3、不同的环境切换比较方便

二、在go中使用配置文件

  • 1、viper网站地址

  • 2、本地安装

    go get github.com/spf13/viper
    
  • 3、简单的读取配置文件

    package main
    
    import (
    	"fmt"
    	"github.com/spf13/viper"
    )
    
    func main() {
    	v := viper.New()
    	v.SetConfigFile("config.yaml")
    	if err := v.ReadInConfig(); err != nil {
    		fmt.Println("读取配置文件失败", err)
    	}
    	fmt.Println(v.Get("name"))
    }
    
  • 4、在文件的同级下创建一个config.yaml的文件

    name: "test"
    
  • 5、使用go run 文件名运行文件,这样直接运行会报错找不到文件

  • 6、建议配置后可以使用右键运行项目

    package main
    
    import (
    	"fmt"
    	"github.com/spf13/viper"
    	"os"
    	"path"
    )
    
    func main() {
    	// 获取项目目录
    	workDir, _ := os.Getwd()
    	v := viper.New()
      // 直接拼接文件目录读取
    	v.SetConfigFile(path.Join(workDir, "test/config.yaml"))
    	if err := v.ReadInConfig(); err != nil {
    		fmt.Println("读取配置文件失败", err)
    	}
    	fmt.Println(v.Get("name"))
    }
    

三、使用结构体的方式读取

  • 1、简单的使用

    package main
    
    import (
    	"fmt"
    	"github.com/spf13/viper"
    	"os"
    	"path"
    )
    
    type ServerConfig struct {
    	Name string `mapstructure:"name"`
    }
    
    func main() {
    	// 获取项目目录
    	workDir, _ := os.Getwd()
    	v := viper.New()
    	v.SetConfigFile(path.Join(workDir, "test/config.yaml"))
    	if err := v.ReadInConfig(); err != nil {
    		fmt.Println("读取配置文件失败", err)
    	}
    	serverConfig := ServerConfig{}
    	if err := v.Unmarshal(&serverConfig); err != nil {
    		fmt.Println("解析结构体失败", err)
    	}
    	fmt.Println(serverConfig.Name)
    }
    
  • 2、结构体的嵌套,很常见的是mysql数据库的配置

    // 定义mysql的
    type MySQLConfig struct {
    	Host string `mapstructure:"host"`
    	Port int `mapstructure:"port"`
    	Username string `mapstructure:"username"`
    	Password string `mapstructure:"password"`
    }
    type ServerConfig struct {
    	Name string `mapstructure:"name"`
    	// 嵌套使用,注意这个地方要和yaml中一样
    	MySqlConfig MySQLConfig `mapstructure:"mysql"`
    }
    
    // 直接使用
    fmt.Println(serverConfig.MySqlConfig)
    

四、区分开发环境和生产环境

  • 1、在mac电脑上配置环境变量,在.bash_profile中导出一个环境变量,注意要关闭goland重新打开

    # vim .bash_profile
    export IS_DEV= true
    source .bash_profile 
    
  • 2、定义方法直接获取环境变量

    func GetEnvInfo(env string) bool {
    	viper.AutomaticEnv()
    	return viper.GetBool(env)
    }
    func main() {
    	fmt.Println(GetEnvInfo("IS_DEV"))
    }
    
  • 3、在目录下创建一个application.dev.ymlapplication.prod.yml的文件,分别存放不同环境下的配置

  • 4、使用环境变量来读取配置完整代码

    func GetEnvInfo1(env string) bool {
    	viper.AutomaticEnv()
    	return viper.GetBool(env)
    }
    
    // 定义mysql的
    type MySQLConfig struct {
    	Host string `mapstructure:"host"`
    	Port int `mapstructure:"port"`
    	Username string `mapstructure:"username"`
    	Password string `mapstructure:"password"`
    }
    type ServerConfig struct {
    	Name string `mapstructure:"name"`
    	// 嵌套使用,注意这个地方要和yaml中一样
    	MySqlConfig MySQLConfig `mapstructure:"mysql"`
    }
    
    func main() {
    	// 获取项目目录
    	workDir, _ := os.Getwd()
    	isDev := GetEnvInfo1("IS_DEV")
    	configFileName := path.Join(workDir, "11.config/application.prod.yml")
    	if isDev {
    		configFileName = path.Join(workDir, "11.config/application.dev.yml")
    	}
    	v := viper.New()
    	v.SetConfigFile(configFileName)
    	if err := v.ReadInConfig(); err != nil {
    		fmt.Println("读取配置文件失败", err)
    	}
    	serverConfig := ServerConfig{}
    	if err := v.Unmarshal(&serverConfig); err != nil {
    		fmt.Println("解析结构体失败", err)
    	}
    	fmt.Println(serverConfig.MySqlConfig)
    }
    

五、在gin中集成配置文件

  • 1、在和main.go同级的目录下创建两个xx.yml的文件

  • 2、目录下创建一个configglobalinitialize的文件夹

  • 3、在config/config.go的文件中书写使用结构体读取配置的

    package config
    
    // 定义mysql的
    type MySQLConfig struct {
    	Host string `mapstructure:"host"`
    	Port int `mapstructure:"port"`
    	Username string `mapstructure:"username"`
    	Password string `mapstructure:"password"`
    }
    type ServerConfig struct {
    	Name string `mapstructure:"name"`
    	// 嵌套使用,注意这个地方要和yaml中一样
    	MySqlConfig MySQLConfig `mapstructure:"mysql"`
    }
    
  • 4、在global/global.go文件中定义全局变量(可能在全项目中某一个文件中需要获取配置)

    var (
    	ServerConfig *config.ServerConfig = &config.ServerConfig{}
    )
    
  • 5、在initialize/config目录初始化配置

    func GetEnvInfo(env string) bool {
    	viper.AutomaticEnv()
    	return viper.GetBool(env)
    }
    
    func InitConfig() {
    	workDir, _ := os.Getwd()
    	isDev := GetEnvInfo("IS_DEV")
    	configFileName := path.Join(workDir, "11.config/application.prod.yml")
    	if isDev {
    		configFileName = path.Join(workDir, "11.config/application.dev.yml")
    	}
    	v := viper.New()
    	//文件的路径如何设置
    	v.SetConfigFile(configFileName)
    	if err := v.ReadInConfig(); err != nil {
    		panic(err)
    	}
    	err := v.Unmarshal(&global.ServerConfig)
    	if err != nil {
    		fmt.Println("读取配置失败")
    	}
    	fmt.Println(&global.ServerConfig)
    }
    
  • 6、在mian.go中初始化配置文件并且打印出信息

    func main() {
    	// 初始化配置
    	initialize.InitConfig()
    	fmt.Println(global.ServerConfig.MySqlConfig)
    }