RestfulConf struct {
    Host         string        `json:",default=0.0.0.0"`
    Port         int           `json:",range=[80,65535)"`
    LogMode      string        `json:",options=[file,console]"`
    Verbose      bool          `json:",optional"`
    MaxConns     int           `json:",default=10000"`
    Timeout      time.Duration `json:",default=3s"`
    CpuThreshold int64         `json:",default=900,range=[0:1000]"`
}

可以看到，我們對每個配置項都有一定的定義和限制，其中一些定義如下：

default，配置沒填的話，使用該默認值，可以看到其中的 3s 會自動解析成 time.Duration 類型
optional，此項可以不配置，沒有的話，用類型零值
range，限定數(shù)字類型，需要在給定的范圍內(nèi)
options，限制配置的值只能是給出的這幾個之一

并且，一些屬性可以疊加使用，比如：

default 和 range 一起使用，就可以既增加了范圍限制，又提供了默認值
default 和 options 一起使用，就可以既增加了可選項限制，又提供了默認值

配置文件

因為我們在定義配置的時候，給了很多的默認值，還有使用 optional 指定為可選，所以我們的配置文件里的配置項就相對比較少了，能用默認值的就不用寫了，如下：

# 因為很多都有默認值，所以只需要寫需要指定值和沒有默認值的
Port: 8080
LogMode: console
# 可以讀取環(huán)境變量的值
MaxBytes: ${MAX_BYTES}

這里有個注意點，如果配置項的 value 全部是數(shù)字，而你定義的配置類型是 string，比如有人測試密碼經(jīng)常用 123456，但是密碼一般會定義為 string，配置就要寫成如下（只是舉個例子哈，密碼一般不建議裸寫到配置文件里）：

Password: "123456"

這里的雙引號不能少，少了會報 type mismatch 之類的錯誤，因為yaml解析器會把不帶雙引號的 123456 解析成 int。

加載配置文件

我們有了配置定義（config.go）和配置文件（config.yaml），接下來就是加載配置文件了，加載配置文件有三種方式：

必須加載成功，否則程序退出，我們一般這么用，如果配置不對，程序就無法繼續(xù)了

// 有錯誤直接退出程序
var config RestfulConf
conf.MustLoad("config.yaml", &config)

go-zero 自帶的 goctl 生成的默認代碼也是使用 MustLoad 來加載配置文件的

加載配置，并自行判斷是否有 error

// 自己判斷并處理 error
var config RestfulConf
// 為了更簡潔，這里的 LoadConfig 后續(xù)會改為 Load，LoadConfig 已被標記為 Deprecated
if err := conf.LoadConfig("config.yaml", &config); err != nil {
    log.Fatal(err)
}

加載配置并讀取環(huán)境變量

// 自動讀取環(huán)境變量
var config RestfulConf
conf.MustLoad(configFile, &config, conf.UseEnv())

這里為啥我們需要顯式指定 conf.UseEnv()，因為如果默認讀取的話，可能在配置里大家寫特定字符的時候就需要 escape 了，所以默認不讀取環(huán)境變量，這個設(shè)計也歡迎大家多提提建議哈

實現(xiàn)原理

我們在實現(xiàn)類似 yaml/json 解析的時候一般會直接使用 encoding/json 或者對應(yīng)的 yaml 庫，但是對于 go-zero 來說，我們需要在 unmarshal 的時候有更精確的控制，這就需要我們自己定制 yaml/json 的解析了，完整的代碼實現(xiàn)在：

配置文件代碼：github.com/zeromicro/g…

yaml/json 解析代碼：github.com/zeromicro/g…

這里也充分展示了 reflect 的用法，以及復雜場景下如何通過單元測試保證代碼的正確性。