go-zero 配置文件：怎么解析、怎么存

config 既不是「全局变量」，也不是「只有 svc 才有」

准确说法是：config 包只定义结构体的「类型」；真正的配置实例在 main.go 里被解析出来（局部变量），然后通过参数传进 svc，作为 svcCtx.Config 字段被业务读取。

配置文件是怎么解析的

go-zero 用自带的 core/conf 包解析，默认读 YAML（也支持 JSON），启动时一次性加载。

// internal/config/config.go —— 只定义「类型」
package config
import ("github.com/zeromicro/go-zero/rest")

type Config struct {
    rest.RestConf          // 内嵌：Name/Host/Port/Mode/Timeout...
    Mysql      MysqlConf
    CacheRedis redis.RedisConf
    Auth       struct {
        AccessSecret string
        AccessExpire int64
    }
}

// main.go —— 真正解析的地方
func main() {
    var c config.Config
    // MustLoad：读 etc/user-api.yaml，反序列化进 c；失败直接 panic
    conf.MustLoad(*configFile, &c)
    // 想要环境变量覆盖 YAML，可加 conf.UseEnv()：
    // conf.MustLoad(*configFile, &c, conf.UseEnv())
    svcCtx := svc.NewServiceContext(c)   // ★ 传进去
    ...
}

解析器做了哪些事

Name: user-api
Host: 0.0.0.0
Port: 8888
Mode: dev          # dev / test / pro
Mysql:
  DataSource: root:123456@tcp(127.0.0.1:3306)/user?charset=utf8mb4&parseTime=true
CacheRedis:
  - Host: 127.0.0.1:6379
    Type: node
Auth:
  AccessSecret: my-secret-key
  AccessExpire: 86400

配置是怎么「存」的：全局变量？还是 svc？

两种候选都被否定了——看代码对照最清楚。

// internal/svc/servicecontext.go
type ServiceContext struct {
    Config config.Config      // ★ 配置以「字段」身份存这里，不是全局变量
    DB     *gorm.DB
    Redis  *redis.Redis
}

func NewServiceContext(c config.Config) *ServiceContext {
    return &ServiceContext{
        Config: c,                              // 把传入的副本收好
        DB:     gorm.Open(mysql.Open(c.Mysql.DataSource)),
        Redis:  redis.New(c.CacheRedis),
    }
}

go-zero 的 Config 长什么样

核心套路：内嵌框架的 Conf（rest/zrpc）+ 自定义业务字段。框架字段负责端口、超时、日志、JWT；自定义字段负责你的 DB、缓存、第三方密钥。

type Config struct {
    rest.RestConf            // 框架：Name/Host/Port/Mode/Timeout/Verbose/CpuThreshold/Log...

    // ---- 以下都是你自己的业务配置 ----
    Mysql   sqlx.MysqlConf      // 数据库
    CacheRedis redis.RedisConf   // 单节点/集群 Redis
    Auth    struct {            // JWT 鉴权
        AccessSecret string
        AccessExpire int64
    }
    UserRpc zrpc.RpcClientConf    // 内部 RPC 客户端（含 etcd 发现）
    PayHttp httpc.ServiceConf     // 外部 HTTP 客户端
}

业务代码里怎么读配置

统一通过 l.svcCtx.Config 读——和读 DB、Redis 一个入口。

// internal/logic/userlogic.go
func (l *UserLogic) UserInfo() (*types.UserInfoResp, error) {
    secret := l.svcCtx.Config.Auth.AccessSecret   // 读自定义配置
    timeout := l.svcCtx.Config.Timeout            // 读框架配置（内嵌）
    dsn := l.svcCtx.Config.Mysql.DataSource      // 读 DB 配置
    ...
}

和其他框架的配置方案比一比

一句话版