应在 main.go 的 init() 函数中调用 godotenv.Load()，确保环境变量加载最早且仅一次；测试时用独立 .env.test 文件并加 -tags test 区分；需显式检查错误，避免静默失败。
Go 项目里怎么加载 .env 文件又不污染 main
直接在 main() 里调用 godotenv.Load() 看似简单，但会导致测试难、环境变量泄漏、配置初始化顺序混乱。真正的做法是把 dotenv 加载提前到应用启动最前端，并限制作用域。
- 在
main.go最顶部（import 之后、任何变量/函数定义之前）加func init() { godotenv.Load(".env") }—— 这样所有包都能看到环境变量，且只执行一次 - 不要在多个地方重复调用
godotenv.Load()，否则可能覆盖或重复解析，尤其在并发 init 阶段会出错 - 如果项目有测试，记得在 test 文件里也加
func init() { godotenv.Load(".env.test") }，并用-tags test区分环境 -
godotenv.Load()默认不报错失败，建议显式检查：if err := godotenv.Load(); err != nil && !os.IsNotExist(err) { log.Fatal(err) }
ConfigMap 挂载的 YAML 怎么跟 Go struct 对齐
Kubernetes 的 ConfigMap 挂载为文件或环境变量时，字段名大小写、嵌套层级、类型转换全是坑。Go 结构体必须严格匹配挂载方式，不能靠“大概能读出来”。
- 如果 ConfigMap 以文件形式挂载（如
/etc/config/app.yaml），用gopkg.in/yaml.v3解析，struct 字段必须带yaml:"field_name"tag，且注意大小写：ConfigMap 里写db_host:，struct 就得是DBHost string `yaml:"db_host"` - 如果 ConfigMap 以环境变量方式挂载（
envFrom: [{configMapRef: {name: app-config}}]），Go 就得用os.Getenv("DB_HOST")手动取，或者用github.com/knadh/koanf这类支持多源的库统一读取 - 避免在 struct 中混用
json和yamltag；同一配置源只走一种序列化路径，否则容易漏字段或类型错位 - YAML 中的
true/false会被解析成 bool，但字符串"true"是 string —— ConfigMap 里别写引号包围布尔值，除非你明确想当字符串处理
dotenv 和 ConfigMap 冲突时，谁优先级更高
没有默认规则，Go 不自动做“合并”或“覆盖”。优先级完全由你读取顺序和赋值逻辑决定。常见错误是以为 os.Getenv() 总是读到 ConfigMap 的值，其实它读的是进程启动时的环境变量快照。
- 如果先执行
godotenv.Load()，再让 Kubernetes 注入 ConfigMap 环境变量，后者会覆盖前者 —— 因为os.Setenv()在 dotenv 里已生效，而 ConfigMap 注入发生在容器启动时，早于 Go 进程内任何代码 - 更可靠的做法：统一用一个配置加载器（比如
koanf），按顺序加载.env→os.Environ()→yaml.File()，每层可设优先级，显式控制覆盖逻辑 - 调试时用
fmt.Printf("DB_HOST=%s", os.Getenv("DB_HOST"))直接验证，别猜；K8s 中可通过kubectl exec -it pod -- env | grep DB看实际注入的环境变量 - 敏感字段（如密码）不要放 .env 文件，哪怕它在本地开发方便 —— 容器镜像里带 .env 是高危操作
为什么 config.New() 一运行就 panic: "nil pointer dereference"
这通常不是配置本身的问题，而是结构体字段没初始化、嵌套 map/slice 未 make、或配置加载失败后继续用了零值 struct。Go 不会自动初始化复杂字段，也不会在解析失败时阻止你用未填充的 config 实例。
立即学习“go语言免费学习笔记（深入）”；
- 别直接声明
var cfg Config后就传给其他模块；要确保cfg已被完整填充，比如封装成NewConfig() (*Config, error)函数，在里面做校验 - 对嵌套结构体字段，必须手动初始化：
type Config struct { DB *DBConfig `yaml:"db"` } type DBConfig struct { Host string `yaml:"host"` } // 使用前：cfg.DB = &DBConfig{} - 用
if cfg.DB == nil { return errors.New("db config missing") }做防御性检查，比 panic 更可控 - 如果用 viper/koanf，记得调用
.Unmarshal(&cfg)后检查返回 error；它不会自动 panic，但很多人忽略返回值
配置最难的从来不是读进来，而是让不同来源的键名、类型、生命周期彼此不打架。尤其当 .env 用于本地开发、ConfigMap 用于 K8s、命令行参数用于临时调试时，字段对不齐、覆盖顺序错、空指针 panic，三者往往一起出现。
