本文介绍 go 项目中跨文件共享 log、config、db 等核心依赖的推荐实践，涵盖单例初始化、依赖注入与包级变量设计，兼顾可测试性与 dry 原则，避免重复初始化和作用域错误。
本文介绍 go 项目中跨文件共享 log、config、db 等核心依赖的推荐实践，涵盖单例初始化、依赖注入与包级变量设计，兼顾可测试性与 dry 原则，避免重复初始化和作用域错误。
在 Go 中，即使多个 .go 文件同属 package main，每个文件仍需显式导入所需包——Go 不支持“包级自动可见性”。你遇到的 undefined: Log 错误，根本原因并非包名冲突或作用域泄露，而是 cache.go 缺少对 logrus 的导入声明。仅在 main.go 中导入 Log "github.com/sirupsen/logrus"，不会让该别名自动生效于其他同包文件。
✅ 正确做法：按需导入 + 统一初始化
首先，在 cache.go 中补全导入（注意：github.com/Sirupsen/logrus 已迁至 github.com/sirupsen/logrus，大小写敏感）：
// cache.go
package main
import (
"github.com/bradfitz/gomemcache/memcache"
log "github.com/sirupsen/logrus" // 显式导入，别名可自定义
"time"
)
var conn = memcache.New("10.1.11.1:11211")
func Set(key string, value []byte, ttl int32) error {
log.Info("Cache: Set: key: ", key) // 使用 log 而非 Log（保持命名一致）
err := conn.Set(&memcache.Item{
Key: key,
Value: value,
Expiration: ttl,
})
if err != nil {
log.WithError(err).Warn("Cache set failed")
}
return err
}但仅靠逐文件导入无法解决“统一配置”和“依赖耦合”问题（如 log 需要 viper 配置，而 viper 初始化失败又需 log 记录）。此时应采用中心化初始化 + 包级变量导出模式：
? 推荐架构：internal/pkg 初始化层
创建 internal/pkg/logger/logger.go（或保留在 main 包内，但逻辑分离）：
// internal/pkg/logger/logger.go
package logger
import (
"github.com/sirupsen/logrus"
"github.com/spf13/viper"
)
var Log *logrus.Logger
func Init() {
Log = logrus.New()
level, err := logrus.ParseLevel(viper.GetString("log.level"))
if err != nil {
// 使用标准 log 输出（避免循环依赖）
panic("invalid log level: " + err.Error())
}
Log.SetLevel(level)
Log.SetFormatter(&logrus.JSONFormatter{})
}在 main.go 中统一初始化：
// main.go
package main
import (
"github.com/spf13/viper"
"your-project/internal/pkg/logger" // 替换为实际路径
"log"
"os"
)
func main() {
// 1. 初始化 viper
viper.SetConfigName("config")
viper.AddConfigPath(".")
if err := viper.ReadInConfig(); err != nil {
log.Fatalf("Read config failed: %v", err)
}
// 2. 初始化 logger（依赖 viper）
logger.Init()
// 3. 启动服务...
// ...
}其他文件（如 cache.go）直接使用已初始化的 logger.Log：
// cache.go
package main
import (
"github.com/bradfitz/gomemcache/memcache"
"your-project/internal/pkg/logger" // 导入 logger 包
)
var conn = memcache.New("10.1.11.1:11211")
func Set(key string, value []byte, ttl int32) error {
logger.Log.Info("Cache: Set: key: ", key)
// ...其余逻辑
}⚠️ 关键注意事项
- 单例保证：logger.Log 是包级变量，Init() 只调用一次，全程唯一实例，无内存浪费；
- 依赖顺序：确保 viper 在 logger.Init() 前完成加载，否则配置读取失败；
- 避免循环导入：logger 包不得反向导入 main 或 config 包；复杂依赖建议使用 依赖注入容器（如 wire）或函数参数传递；
- 可测试性：生产环境用包级变量，单元测试时可通过 logger.Log = testLogger 替换，或改用构造函数注入（如 NewCache(logger *logrus.Logger)）；
- viper 迁移提示：新版 viper 支持 viper.Unmarshal() 直接绑定结构体，比手动 GetString() 更安全。
✅ 总结
Go 的“显式导入”是设计哲学而非缺陷。解决跨文件共享依赖的核心思路是：
1️⃣ 每个使用方显式导入所需包（修复编译错误）；
2️⃣ 通过包级变量 + 初始化函数实现单例共享（满足 DRY 和配置一致性）；
3️⃣ 将初始化逻辑下沉到专用包，明确依赖顺序（解耦 log 与 config）；
4️⃣ 高阶项目考虑 wire 或 fx 等 DI 框架，替代硬编码包级状态。
这样既符合 Go 的简洁性原则，又为后续扩展 DB、Cache、Metrics 等组件预留清晰架构路径。
