读取环境变量#

通过 BindEnv 和 AutomaticEnv 读取环境变量，并验证结构体解码的键绑定。

本系列使用 Viper v1.21.0。每章都是独立实验，示例命令在项目目录中执行；开始新一章时，使用该章的完整程序和配置，不累积上一章的临时修改。

尚未准备练习项目时，先完成第 1 章的项目准备。

初始示例#

初始配置 config/config.yaml：

1
app:
2
  name: viper-demo
3
  port: 8080

初始完整 main.go：

1
package main
2

3
import (
4
  "fmt"
5
  "github.com/spf13/viper"
6
  "log"
7
)
8

9
func main() {
10
  v := viper.New()
11
  v.SetConfigFile("config/config.yaml")
12
  v.SetDefault("app.port", 3000)
13

14
  if err := v.BindEnv("app.port", "APP_PORT"); err != nil {
15
    log.Fatal(err)
16
  }
17
  if err := v.ReadInConfig(); err != nil {
18
    log.Fatal(err)
19
  }
20

21
  fmt.Println("监听端口:", v.GetInt("app.port"))
22
}

执行：

1
env APP_PORT=9090 go run main.go

预期端口为 9090，YAML 仍为 8080。BindEnv 第一个参数是配置键，第二个参数是确切的环境变量名。环境变量优先于文件配置，但不会修改文件。

第一次修改#

在 import 中增加：

1
"strings"

删除原来的 BindEnv("app.port", "APP_PORT") 错误检查块，替换为：

1
v.SetEnvPrefix("LEARN")
2
v.SetEnvKeyReplacer(strings.NewReplacer(".", "_"))
3
v.AutomaticEnv()

执行：

1
env LEARN_APP_PORT=7070 go run main.go

预期端口为 7070。前缀、替换器和大写规则共同形成 app.port → LEARN_APP_PORT。

第二次修改#

保留自动映射设置，在获取配置之前增加：

1
if err := v.BindEnv("app.port"); err != nil {
2
    log.Fatal(err)
3
}

只传配置键时按前缀和替换规则查找；如果明确传第二个参数 "APP_PORT"，则直接使用该名称，不自动追加前缀。

对于结构体解码，AutomaticEnv 不会枚举全部环境变量并注册所有键。某字段如果只存在于环境变量中、文件和默认值都没有提供，普通解码可能读不到；显式绑定可以让这个键参与解码。

第三次修改#

将本章程序完整替换为下面的例子，单独验证“只通过环境变量解码结构体”：

1
package main
2

3
import (
4
  "fmt"
5
  "github.com/spf13/viper"
6
  "log"
7
)
8

9
type Config struct {
10
  App struct {
11
    Port int `mapstructure:"port"`
12
  } `mapstructure:"app"`
13
}
14

15
func main() {
16
  v := viper.New()
17
  if err := v.BindEnv("app.port", "APP_PORT"); err != nil {
18
    log.Fatal(err)
19
  }
20
  var cfg Config
21
  if err := v.UnmarshalExact(&cfg); err != nil {
22
    log.Fatal(err)
23
  }
24
  fmt.Println("结构体端口:", cfg.App.Port)
25
}

执行 env APP_PORT=9090 go run main.go，预期结构体端口为 9090。执行 env APP_PORT=abc go run main.go，应报告整数转换错误。

环境变量名称区分大小写。空环境变量默认视为未设置，会回退到其他来源。

HikariTish

读取环境变量#

初始示例#

第一次修改#

第二次修改#

第三次修改#

参考资料#

Viper 学习记录

继续阅读

换条路线

HikariTish

读取环境变量#

初始示例#

第一次修改#

第二次修改#

第三次修改#

参考资料#

分享文章

沿着主题读

换条路线