本文介绍如何使用 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 在空值或无 = 时行为需额外校验）。
以下是完整示例代码：
One-click installation of GitHub projects
下载
GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。
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 “简洁即强大”的工程哲学。
