Go编译器禁止import循环，因依赖图出现A→B→A闭环时立即报错；需通过接口抽象、职责拆分（如model/repo/service分包）、回调注入等方式从源码层面切断循环依赖。
为什么 go build 会报 “import cycle not allowed”
Go 编译器在解析 import 语句时会构建依赖图，一旦发现 A → B → A 这类闭环路径，立刻终止编译并抛出 import cycle not allowed 错误。这不是警告，是硬性限制——Go 语言设计上就拒绝运行时或链接期解决循环依赖，必须在源码结构层面切断。
常见诱因包括：
- 两个
.go文件互相import同一包（比如user.go导入order.go的函数，order.go又导入user.go的结构体） - 接口定义和实现混在同一包，而另一包同时依赖该包的接口和实现逻辑
- 错误地把领域模型（如
User）、仓储接口（UserRepo）和数据库实现（mysqlUserRepo）全塞进user/包里，导致 service 层调用 repo 时又被迫拉入 DB 驱动依赖
用 interface + 依赖倒置拆开 concrete 实现
核心思路：把“谁来实现”和“谁来使用”分离，让高层模块（如 service）只依赖抽象（interface），底层模块（如 repository 实现）反过来依赖抽象，从而打破单向 import 链中的闭环。
例如，原本 service/user_service.go 直接调用 repo/mysql_user_repo.go 中的 SaveUser()，而 mysql_user_repo.go 又需要引用 model/user.go 的 User 结构体 —— 如果 user.go 又 import 了 service 包做校验逻辑，循环就形成了。
立即学习“go语言免费学习笔记（深入）”；
重构方式：
- 在
repo/包中定义UserRepo接口，只放方法签名，不依赖任何具体 model 或 service - 把
User结构体移到独立的model/包（不 import 其他业务包） -
service/包 importmodel/和repo/（只用接口），不 importmysql/ -
mysql/包 importmodel/和repo/（实现接口），不 importservice/
package repo
type UserRepo interface {
Save(*model.User) error
FindByID(int) (*model.User, error)
}
通过 callback / functional option 消除跨包状态传递
当两个包之间因“共享配置”或“回调通知”产生隐式依赖时，容易诱发循环。比如 httpserver/ 包为了触发业务逻辑，直接调用 service/ 包函数；而 service/ 包又想在操作完成后发 HTTP 请求，反向 import httpserver/ —— 这本质是职责错位。
更干净的做法是把可变行为抽成参数：
- 用
func(context.Context, *model.User) error类型作为回调传入，httpserver/不再知道service/的存在 - 用 functional option 模式初始化组件，把依赖延迟到
main()组装时注入 - 避免在包级变量中缓存跨包实例（如
var svc Service），改用构造函数返回
示例：服务启动时不硬编码依赖
func NewHTTPServer(
userHandler http.HandlerFunc,
opts ...ServerOption,
) *HTTPServer {
s := &HTTPServer{}
for _, opt := range opts {
opt(s)
}
s.mux.HandleFunc("/user", userHandler)
return s
}
什么时候该拆新包？看 import 路径是否承担多于一种职责
一个包名如 user 听起来合理，但如果它同时包含 User 结构体、ValidateUser() 校验函数、SendWelcomeEmail() 发信逻辑、以及 GetUserFromDB() 数据库查询 —— 它已经混杂了 domain model、business rule、infrastructure 和 application service 四层职责，必然引发依赖纠缠。
判断标准：
- 该包是否被多个其他包以不同目的 import？（比如
api/为序列化 import 它，worker/为发邮件 import 它，db/为建表 import 它）→ 应拆 - 该包是否 import 了本不该知道的包？（如
model/包 importredis/）→ 违反分层，必须切离 - 该包的
go test是否必须启数据库或 HTTP server 才能跑通？→ 说明它耦合了 infra，要剥离 interface
真正稳定的包只有三种：纯数据（model/）、纯抽象（repo/, event/）、纯组合（cmd/, main.go）。其余都该按变化原因隔离。
