如何在 Go 中读取环境变量并合并到 JSON 配置中

本文介绍如何使用 go 标准库高效获取所有环境变量并构建成 map[String]string，再将其与 json 配置文件解析结果合并，实现配置优先级（环境变量 > json 文件），适用于云原生和微服务场景。

在 go 应用中，常需将环境变量作为运行时配置的最终覆盖层（例如 docker/K8s 环境下动态注入 DATABASE_URL 或 LOG_LEVEL）。虽然 os.Getenv(“KEY”) 可按需获取单个变量，但若需全量加载并统一合并至 jsON 配置结构中，更推荐先调用 os.Environ() 获取全部键值对，再构建映射。

os.Environ() 返回 []string，每个元素形如 “KEY=VALUE”（注意：VALUE 可能含等号，但 KEY 不含；标准 POSIX 环境变量名仅允许字母、数字和下划线，且不能以数字开头）。因此安全解析方式是从左向右查找第一个 = 位置，而非 strings.SplitN(e, “=”, 2) 的简写（虽常用，但 SplitN 在空值或无 = 时行为需额外校验）。

以下是完整示例代码：

package main  import (     "encoding/json"     "io/ioutil"     "log"     "os"     "strings" )  // loadEnvAsMap 将所有环境变量解析为 map[string]string func loadEnvAsMap() map[string]string {     m := make(map[string]string)     for _, e := range os.Environ() {         if i := strings.Index(e, "="); i > 0 { // i > 0 排除以 "=" 开头的非法键（如 "=invalid"）             key, value := e[:i], e[i+1:]             m[key] = value         }     }     return m }  func main() {     configFilePath := "config.json"      // 1. 解析 JSON 配置     var config map[string]interface{}     data, err := ioutil.ReadFile(configFilePath)     if err != nil {         log.Fatalf("failed to read config file: %v", err)     }     if err := json.Unmarshal(data, &config); err != nil {         log.Fatalf("failed to unmarshal JSON config: %v", err)     }      // 2. 加载环境变量映射     envMap := loadEnvAsMap      // 3. 合并：环境变量优先级高于 JSON（覆盖同名键）     // 注意：envMap 值为 string，而 config 中可能是 number/bool/object ——      // 若需类型自动转换，建议使用专用库如 github.com/mitchellh/mapstructure     for key, value := range envMap {         config[key] = value // 强制字符串覆盖（最简安全策略）     }      // 此时 config 已融合环境变量，可直接用于后续逻辑     log.Printf("Merged config: %+v", config) }

⚠️ 注意事项：

• 环境变量名默认全大写（如 GOPATH），而 JSON 配置键可能为小写（如 “gopath”），合并前建议统一键名规范（例如全部转大写或使用映射表）；
• ioutil.ReadFile 在 Go 1.16+ 已弃用，生产环境请替换为 os.ReadFile；
• 若需深度合并嵌套结构（如 DB.HOST → config[“db”][“host”]），应采用前缀分隔（如 DB_HOST）配合结构体或第三方库（如 github.com/knqyf263/pet 或自定义解析器）；
• 安全起见，避免将敏感环境变量（如 API_KEY）直接注入日志或响应体。

通过该方式，你既能保持配置灵活性，又无需引入外部依赖，符合 Go “简洁即强大”的工程哲学。