在 Go 语言中，同包下的所有文件共享同一个命名空间，因此不能在多个文件中声明同名的包级变量（如 instance），否则会触发 “redeclared in this block” 编译错误。解决方法是确保包级标识符唯一，或通过封装隔离作用域。
在 go 语言中，同包下的所有文件共享同一个命名空间，因此不能在多个文件中声明同名的包级变量（如 `instance`），否则会触发 “redeclared in this block” 编译错误。解决方法是确保包级标识符唯一，或通过封装隔离作用域。
Go 与 Java、Python 等语言不同：文件（.go 文件）本身不构成作用域边界，而只是源码组织单元。所有包级声明（包括变量、函数、类型）在编译时会被合并到同一包作用域中。这意味着，即使 daoFactory.go 和 fakeProvisionDao.go 是两个独立文件，只要它们同属 dao 包，其中定义的顶层变量 var instance *daoFactory 和 var instance *provisionDao 就会因重名而冲突。
✅ 正确做法是为每个单例变量赋予语义明确且唯一的名称，例如：
// daoFactory.go
package dao
type daoFactory struct{}
var daoFactoryInstance *daoFactory // ✅ 命名体现类型与用途
// fakeProvisionDao.go
package dao
type provisionDao struct{}
var provisionDaoInstance *provisionDao // ✅ 避免歧义，便于维护⚠️ 更推荐的工程实践是封装单例逻辑，而非暴露裸变量。例如使用私有变量 + 导出初始化函数：
// daoFactory.go
package dao
type daoFactory struct{}
var factoryInstance *daoFactory
// Factory returns the singleton instance of daoFactory.
func Factory() *daoFactory {
if factoryInstance == nil {
factoryInstance = &daoFactory{}
}
return factoryInstance
}// fakeProvisionDao.go
package dao
type provisionDao struct{}
var provisionInstance *provisionDao
// ProvisionDao returns the singleton instance of provisionDao.
func ProvisionDao() *provisionDao {
if provisionInstance == nil {
provisionInstance = &provisionDao{}
}
return provisionInstance
}这样既避免了命名冲突，又隐藏了实现细节，符合 Go 的“显式优于隐式”原则。同时，若需并发安全，可在初始化逻辑中加入 sync.Once：
var (
provisionInstance *provisionDao
provisionOnce sync.Once
)
func ProvisionDao() *provisionDao {
provisionOnce.Do(func() {
provisionInstance = &provisionDao{}
})
return provisionInstance
}? 总结：
- Go 中包是唯一的作用域单位，跨文件同名包级变量必然冲突；
- 命名应遵循 驼峰式+语义化（如 userRepoInstance），杜绝通用名（如 instance, obj, data）；
- 优先使用函数封装单例获取逻辑，而非导出裸变量；
- 多实例场景下，可考虑依赖注入（如使用 wire）替代全局单例，提升可测试性与解耦度。
