Go模块不支持运行环境级依赖切换，因编译期已确定import，GO_ENV等运行时变量无法影响导入；正确做法是通过接口定义行为契约，各环境实现该接口，并在main中按GO_ENV显式初始化对应实现。
Go 模块本身不支持“运行环境”级依赖切换，所谓“不同运行环境解耦”，本质是避免硬编码环境逻辑，把配置、实现、行为三者分离——不是靠工具自动识别 dev/staging/prod，而是靠接口 + 初始化时机 + 显式注入来控制。
为什么 GO_ENV 不能直接控制依赖加载
Go 编译期就确定所有 import 包，GO_ENV 是运行时环境变量，对 import 行为完全无影响。常见错误是写这样的代码：
if os.Getenv("GO_ENV") == "test" {
import "github.com/myorg/db/fake" // ❌ 语法错误：import 不在文件顶部
}
这类写法根本通不过编译。真正可行的方式是：让同一接口在不同环境由不同实现满足，而接口调用方不感知差异。
- 接口定义必须独立于具体实现（推荐放在
interfaces/或业务顶层包） - 具体实现包（如
db/mysql、db/memory）只依赖接口，不反向依赖调用方 - 初始化逻辑（如
db.NewClient()）必须在main()或启动函数中显式调用，并根据环境变量返回对应实现
如何用接口 + 工厂函数做环境适配
以数据库客户端为例，目标是 dev 用内存模拟、prod 用 MySQL、test 用 SQLite。关键不在“自动切换”，而在“谁决定用哪个”。
立即学习“go语言免费学习笔记（深入）”；
第一步：定义统一接口（放在 interfaces/db.go）
package interfaces
type DBInterface interface {
Query(string, ...interface{}) ([]map[string]interface{}, error)
Exec(string, ...interface{}) (int64, error)
}
第二步：各环境实现各自满足该接口，且互不 import 对方
-
db/memory/client.go实现DBInterface，不 importmysql包 -
db/mysql/client.go同样只实现接口，不 importmemory
第三步：在 main.go 中按需初始化
func initDB() (interfaces.DBInterface, error) {
env := os.Getenv("GO_ENV")
switch env {
case "dev":
return memory.NewClient(), nil
case "prod":
return mysql.NewClient(), nil
case "test":
return sqlite.NewClient(), nil
default:
return nil, fmt.Errorf("unknown GO_ENV: %s", env)
}
}
注意：initDB 必须被显式调用，不能藏在某个包的 init() 函数里——否则无法控制加载顺序，也难以测试。
容易踩的坑：间接依赖暴露环境细节
当某包（如 service/user.go）直接 import db/mysql，即使它只调用一个函数，也会把 MySQL 驱动、连接池、配置结构体等全拉进来。这导致：
- test 环境跑不起来（因为没配 MySQL 连接）
- 二进制体积膨胀（MySQL 驱动含 Cgo，静态链接困难）
- CI 流水线必须起真实 DB 才能跑单元测试
正确做法是：所有业务包只 import interfaces，绝不 import 具体实现包。哪怕只是临时写个 fmt.Println(mysql.Version)，也会污染依赖图。
验证是否干净：运行 go list -f '{{.Deps}}' ./service | grep mysql，结果应为空。
复杂点在于配置初始化时机与生命周期管理
接口解耦只是第一步，真正难的是让不同实现共享同一套配置结构、日志实例、重试策略等。这些不能靠全局变量（易并发冲突），也不能每个实现都重新解析一遍 config.yaml（重复 IO、版本不一致）。
推荐方式是：把配置结构体定义在 config/ 包，所有实现工厂函数接收该结构体作为参数：
func NewMySQLClient(cfg config.DatabaseConfig) DBInterface { ... }
func NewMemoryClient(cfg config.DatabaseConfig) DBInterface { ... }
这样既解耦了实现，又保证了配置来源唯一、解析一次、复用到底。漏掉这点，环境切换看似成功，实则各模块用的超时时间、重试次数可能完全不同。
