在 Go 项目中，可通过 init() 函数确保全局配置仅初始化一次；为避免并发竞争，应将变量设为未导出，并配合 sync.Mutex 提供线程安全的访问接口。
在 go 项目中，可通过 `init()` 函数确保全局配置仅初始化一次；为避免并发竞争，应将变量设为未导出，并配合 `sync.mutex` 提供线程安全的访问接口。
在 Go 语言中，全局变量的“一次性初始化”是一个常见需求，尤其适用于应用配置、连接池、单例服务等场景。直接将函数调用赋值给导出的全局变量（如 var ConfigMap = GetAppConfig()）会导致每次包被导入或变量被引用时都重新执行初始化逻辑——这不仅低效，还可能引发重复加载、资源泄漏甚至竞态问题。
正确的做法是分离初始化时机与访问方式：
使用 init() 函数实现单次初始化
init() 是 Go 的特殊函数，每个包中可定义多个，它们在 main() 执行前自动、按依赖顺序、且仅执行一次。适合用于预加载配置、初始化全局状态。将底层变量设为未导出（小写首字母）
避免外部直接读写，防止并发修改或误用。例如使用 configMap 而非 ConfigMap。提供受保护的导出访问接口
通过带锁的 getter 函数（如 Config(key string) string）控制读取，确保并发安全。
以下是推荐的完整实现示例（位于 utils/config.go）：
package utils
import "sync"
var (
configMap map[string]string
confMu = &sync.Mutex{}
)
func init() {
configMap = GetAppConfig() // 确保只执行一次
}
// GetAppConfig 模拟配置加载逻辑（实际中可从文件、环境变量或远程服务读取）
func GetAppConfig() map[string]string {
return map[string]string{
"db_host": "localhost",
"redis_url": "redis://127.0.0.1:6379",
"app_env": "production",
}
}
// Config 安全获取配置项，支持并发调用
func Config(key string) string {
confMu.Lock()
defer confMu.Unlock()
return configMap[key]
}
// ConfigMapCopy 返回配置副本（如需遍历或批量使用，避免锁持有过久）
func ConfigMapCopy() map[string]string {
confMu.Lock()
defer confMu.Unlock()
copy := make(map[string]string, len(configMap))
for k, v := range configMap {
copy[k] = v
}
return copy
}
✅ 使用示例（在 main.go 或任意其他包中）：
package main
import (
"fmt"
"your-project/utils"
)
func main() {
fmt.Println("DB Host:", utils.Config("db_host")) // 输出: localhost
fmt.Println("Env:", utils.Config("app_env")) // 输出: production
cfg := utils.ConfigMapCopy() // 获取完整副本
fmt.Printf("All configs: %+v\n", cfg)
}
⚠️ 注意事项：
- 不要试图在 init() 中执行耗时或可能失败的操作（如网络请求、文件 I/O），除非已做好重试与错误处理；否则可能导致程序启动失败且难以调试。
- 若配置需热更新，应改用 sync.Once + 原子指针替换，或引入配置监听机制（如 fsnotify），而非依赖静态 init()。
- 对于结构体或复杂对象，建议使用 sync.Once 封装初始化逻辑，比 init() 更灵活可控（尤其在测试场景下便于重置）。
综上，init() 是实现“启动期单次初始化”的简洁方案，而配合互斥锁与未导出变量的设计，则兼顾了安全性、可维护性与 Go 的惯用风格。
