Go中循环依赖指包间互相import导致编译报错import cycle not allowed，属编译期硬性限制；可通过接口解耦、提取公共model包、函数参数传递依赖及排查隐式依赖链解决。
什么是 Go 中的循环依赖
Go 编译器在构建阶段会直接报错 import cycle not allowed，只要两个或多个包通过 import 语句互相引用，就构成循环依赖。它不是运行时问题，而是编译期硬性限制——Go 不支持任何形式的循环 import，哪怕间接（A→B→C→A）也不行。
用接口解耦：把具体实现移到下游包
最常见的误写是：包 user 定义了 User 结构体和 Save() 方法，同时又依赖 db 包来执行 SQL；而 db 包为了做类型断言或预处理，又反向 import user。解决方式是让 db 接收接口而非具体结构体：
package db
<p>type Saver interface {
GetID() int64
ToMap() map[string]interface{}
}</p><p>func Insert(s Saver) error {
// 使用 s.GetID() 和 s.ToMap()
}然后在 user 包中实现该接口：
package user
<p>func (u <em>User) GetID() int64 { return u.ID }
func (u </em>User) ToMap() map[string]interface{} { /<em> ... </em>/ }这样 db 只 import 标准库和自身，user import db 即可，依赖方向唯一。
立即学习“go语言免费学习笔记（深入）”；
提取公共接口到独立的 contract 或 model 包
当多个包都需要共享类型定义（如 Order、PaymentStatus），但又不能让其中任一业务包成为“中心依赖”，就应新建一个无逻辑、只含 type 和 const 的包：
-
model包只包含type Order struct{...}、type Status int等纯数据声明 -
order包 importmodel实现业务方法 -
payment包也 importmodel，但不 importorder
关键点：model 不能 import 任何业务包；否则它就不再是“底座”而是新的依赖环起点。
用函数参数或回调代替包级依赖
有些场景看似必须双向调用，比如 auth 包需要校验用户权限，而权限规则由 rbac 包提供。这时不要让 auth import rbac，而是把校验逻辑以函数形式传入：
package auth
<p>type CheckPermissionFunc func(userID int64, resource string, action string) bool</p><p>func VerifyToken(token string, check CheckPermissionFunc) error {
// ...
if !check(userID, "post", "create") {
return errors.New("forbidden")
}
}调用方（如 HTTP handler）组合依赖：
import (
"myapp/auth"
"myapp/rbac"
)
<p>func handleCreatePost(w http.ResponseWriter, r *http.Request) {
auth.VerifyToken(token, rbac.CheckPermission)
}这种方式把依赖关系从编译期转移到运行期组装，彻底避开 import 循环。
真正难处理的是那些隐式依赖：比如日志中间件偷偷 import 了 metrics 包，而 metrics 又依赖了 config 包，config 初始化时又触发了 logger 初始化……这类链式间接循环，得靠 go list -f '{{.Imports}}' package 逐层检查 import 图，再配合 _ 空导入或延迟初始化来拆解。
