Go语言无原生配置文件支持，需用encoding/json解析JSON、gopkg.in/yaml.v3解析YAML、github.com/joho/godotenv加载.env，或viper统一管理多格式；所有配置必须显式读取并绑定到导出结构体字段。
Go 语言本身没有原生的“属性文件”（如 Java 的 .properties 或 Python 的 .env）支持，也不提供类似 config.properties 那样的内置加载机制。所谓“属性文件定义”，实际是开发者自行约定 + 第三方库或标准库组合实现的配置管理方案。
直接说结论：你不能像写 Spring Boot 那样在 Go 里放个 application.yml 就自动注入变量；所有配置都要显式读取、解析、赋值——但好处是控制权完全在你手上，没有魔法，没有隐式行为。
怎么读取外部配置文件（JSON/TOML/YAML/ENV）
Go 标准库只原生支持 JSON（encoding/json），其他格式需依赖第三方库。常见组合如下：
-
JSON：用json.Unmarshal+ 结构体，零依赖，适合简单场景 -
TOML：推荐github.com/pelletier/go-toml/v2，轻量、无反射、性能好 -
YAML：常用gopkg.in/yaml.v3，注意它会把int和float64混淆（如123可能被当float64） -
.env：用github.com/joho/godotenv加载环境变量，再通过os.Getenv读取
示例（读取 config.json）：
立即学习“go语言免费学习笔记（深入）”；
type Config struct {
Port int `json:"port"`
Database string `json:"database"`
Debug bool `json:"debug"`
}
func loadConfig() (*Config, error) {
data, err := os.ReadFile("config.json")
if err != nil {
return nil, err
}
var cfg Config
if err := json.Unmarshal(data, &cfg); err != nil {
return nil, err
}
return &cfg, nil
}变量如何绑定到配置字段（结构体 vs 全局变量）
新手常误用包级变量直接存配置值，比如：
var DBHost = "localhost" // ❌ 危险：无法在运行时更新，且测试难 mock
正确做法是把配置封装进结构体，按需传参或作为依赖注入：
-
main()中解析后构造*Config实例 - 服务初始化函数（如
NewUserService(cfg *Config)）接收该实例 - 避免全局可变状态，利于单元测试和多环境切换
关键点：
- 不要用
var直接声明配置值（除非是真正不变的常量，如const Version = "1.2.0"） - 所有可配置项必须归属某个结构体，且字段名与配置文件 key 对应（靠 tag 控制）
- 若需运行时重载（如监听文件变化），结构体实例必须可替换，不能靠修改包级变量实现
环境变量与配置文件的优先级怎么设
真实项目中，配置来源通常有多个：文件 → 环境变量 → 命令行参数。Go 没有默认规则，你得自己定优先级。通用做法是：
- 环境变量覆盖配置文件（例如
DATABASE_URL优先于config.json中的database字段） - 使用
os.Getenv显式检查，再决定是否覆盖结构体字段 - 推荐工具：
github.com/spf13/viper（但注意它较重，有隐式行为；小项目建议手写逻辑）
一个轻量覆盖逻辑示例：
if url := os.Getenv("DATABASE_URL"); url != "" {
cfg.Database = url
}容易被忽略的坑
这些不是“语法错误”，但上线后极难排查：
-
json.Unmarshal对未导出字段（小写首字母）静默忽略，字段始终为零值，不报错也不提示 -
yaml.v3默认把数字全转成float64，若结构体字段是int，反序列化会失败（需用yaml:",int"tag 或自定义 unmarshal） - 配置文件路径硬编码（如
"./config.json"），导致 Docker 容器内找不到；应统一用flag.String("config", "", "config file path")或从os.Args提取 - 把敏感配置（密码、密钥）写死在代码或版本库中；必须用环境变量或 secret manager 注入，且代码里禁止出现
"password": "xxx"这类字面量
最麻烦的其实是类型推断边界：TOML/YAML 支持混合类型（如数组里既有字符串又有整数），而 Go 结构体要求严格匹配。一旦配置格式松动，程序就 panic —— 所以务必加 if err != nil 校验，且日志要打出原始配置内容片段。
