读取Go项目中的配置文件的方法

Go语言提供了很简便的读取json和yaml文件的api，我们可以很轻松将一个json或者yaml文件转换成Go的结构体，但是如果直接在项目中读取配置文件，这种方式并不够好。缺点如下：

实际开发中配置项在不同环境下，配置的值是不同的

上面的问题可以通过不同的配置文件去决定在那个环境读取那个配置文件，但是还有一个问题就是实际开发中，配置项有些是相同的，有些是不同的，如果配置文件有一个主配置文件，里面存放的是不同环境相同的配置项，还有一个跟随环境的配置文件，里面存放的是不同环境的配置项，然后读取两个配置文件后，做一个merge，这样得到的结果就是总共的配置项信息。

有些配置项是必填的，有些配置项的值是一些特殊的值，比如,邮箱,手机号，IP信息等

来看看gonfig是怎么解决这个问题的

• 安装gonfig

go get github.com/xiao-ren-wu/gonfig

• 项目中新建配置目录，并编写对应配置文件，在配置目录同级目录添加读取配置文件的go文件

conf.yamlconf-{{active}}.yaml

conf
   |-conf.yaml
   |-conf-dev.yaml
   |-conf-prod.yaml
   |config.go

go:embedgonfig.Unmarshal

package config

import (
   "model"
   "github.com/xiao-ren-wu/gonfig"
   "embed"
)

//go:embed *.yaml
var confDir embed.FS

// 我们配置文件的配置struct
type AppConf struct {
	AppName string `yaml:"app-name" json:"app-name"`
	DB      DBConf `yaml:"db" json:"db"`
}

type DBConf struct {
	Username string `yaml:"username" json:"username"`
	Password string `yaml:"password" json:"password"`
}

var conf Conf

func Init() {
   if err := gonfig.Unmarshal(confDir, &conf); err != nil {
      panic(err)
   }
}

func GetConf() *Conf {
   return &conf
}

conf-{{profile}}.yamlconf.yamlconf-{{profile}}.yamlconf.yamlconf-{{profile}}.yaml

约定

gonfig

gonfig.Unmarshalconfprofileconf.yamlconf-{{profile}}.yamlconf-{{profile}}.yamlconf.yamlconf-{{profile}}.yaml

根据项目定制化配置文件

gonfig.Unmarshalfunc Unmarshal(confDir ReadFileDir, v interface{}, ops ...Option) error 

FilePrefix(prefix string)UnmarshalWith(uType UnmarshalType)ProfileUseEnv(envName, defaultProfile string)ProfileFunc(f func() string)

原理篇

gonfig

func Unmarshal(confDir ReadFileDir, v interface{}, ops ...Option) error {
	if v != nil && reflect.ValueOf(v).Kind() != reflect.Ptr {
		return gonfig_error.ErrNonPointerArgument
	}

	var cs = &confStruct{
		confPrefix:      "conf",
		envName:         "profile",
		defaultEnvValue: "dev",
		unmarshalType:   Yaml,
	}
	cs.activeProfileFunc = func() string {
		return getActiveProfile(cs.envName, cs.defaultEnvValue)
	}

	for _, op := range ops {
		op(cs)
	}

	cs.profileActive = cs.activeProfileFunc()

	if err := loadConf(confDir, cs); err != nil {
		return err
	}

	// copy val
	v1 := reflect.New(reflect.TypeOf(v).Elem()).Interface()

	if err := fileUnmarshal(cs.activeConfRaw, v1, cs.unmarshalType); err != nil {
		return err
	}

	if len(cs.masterConfRaw) == 0 {
		return gonfig_error.MasterProfileConfNotSetError
	}

	if err := fileUnmarshal(cs.masterConfRaw, v, cs.unmarshalType); err != nil {
		return err
	}

	return mergo.Merge(v, v1, mergo.WithOverride)
}

conf-{{profile}}.yamlconf.yamlmergo

gonfig

github地址是：https://github.com/xiao-ren-wu/gonfig