在 go 中，使用 `:=` 声明变量时若左侧存在同名包级变量，会意外创建新局部变量而非赋值给全局变量；修复方式是显式声明 `err` 后用 `=` 赋值，但更推荐避免全局状态、改用返回值与依赖注入。
Go 的短变量声明操作符 := 本质是带初始化的局部变量声明，而非赋值。当代码中出现：
var Conn *sql.DB // 包级变量，初始为 nil
func Init(user, pwd, dbname string, port int) {
Conn, err := sql.Open("postgres", "...") // ❌ 错误！此处 Conn 是新声明的局部变量
// 外部的 Conn 仍为 nil，且该局部 Conn 在函数结束时即被丢弃
}编译器会将 Conn, err := ... 解析为：同时声明两个新变量 Conn（局部）和 err（局部） —— 即使包级已存在同名 Conn，Go 也不会自动“降级”为赋值。这是 Go 作用域与声明语义的明确设计，不是 bug，而是可预测性的体现。
✅ 正确修复方式（仅当必须使用全局变量时）：
func Init(user, pwd, dbname string, port int) error {
var err error
Conn, err = sql.Open("postgres", "...") // ✅ 使用 = 赋值，明确操作包级 Conn
return err
}注意：Conn, err = ... 要求 err 已预先声明（类型确定），否则语法错误；且 Conn 必须是可寻址的导出/非导出包级变量（不能是常量或未声明标识符）。
⚠️ 但更关键的是：应优先避免全局变量。理由包括：
- 测试困难：全局状态导致单元测试间相互污染，难以 mock 或重置；
- 并发不安全：未加锁的全局 *sql.DB 在多 goroutine 初始化或重置时易引发竞态；
- 依赖隐式化：调用方无法感知 Init() 对全局状态的副作用，违反显式依赖原则。
✅ 推荐做法：返回值 + 依赖注入
// 纯函数式初始化，无副作用
func NewDB(user, pwd, dbname string, port int) (*sql.DB, error) {
db, err := sql.Open("postgres", fmt.Sprintf("user=%s password=%s dbname=%s port=%d", user, pwd, dbname, port))
if err != nil {
return nil, fmt.Errorf("failed to open DB: %w", err)
}
if err := db.Ping(); err != nil {
db.Close()
return nil, fmt.Errorf("failed to ping DB: %w", err)
}
return db, nil
}
// 使用方显式持有连接（例如在 main 或结构体中）
func main() {
db, err := NewDB("user", "pass", "mydb", 5432)
if err != nil {
log.Fatal(err)
}
defer db.Close()
// 传递 db 到需要它的组件（如 repository、handler）
handler := &UserHandler{DB: db}
}? 进阶建议：
- 将 *sql.DB 封装进自定义结构体（如 type App struct { DB *sql.DB }），实现清晰的生命周期管理；
- 使用 sync.Once 安全地惰性初始化单例（若真需全局访问），但依然推荐构造时传入；
- 在测试中，直接传入 sqlmock 或内存数据库实例，彻底解耦。
总结：Go 没有 package.Conn 这样的语法来强制引用包级变量——这是有意为之的设计约束。它迫使开发者直面变量作用域，从而写出更清晰、可测、可维护的代码。拥抱返回值与显式依赖，才是 Go 的惯用之道。
