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 dbtype Saver interface { GetID() int64 ToMap() map[string]interface{} }
func Insert(s Saver) error { // 使用 s.GetID() 和 s.ToMap() }
然后在 user 包中实现该接口：
package userfunc (u User) GetID() int64 { return u.ID } func (u User) ToMap() map[string]interface{} { / ... / }
这样 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 authtype CheckPermissionFunc func(userID int64, resource string, action string) bool
func VerifyToken(token string, check CheckPermissionFunc) error { // ... if !check(userID, "post", "create") { return errors.New("forbidden") } }
调用方（如 HTTP handler）组合依赖：
import (
"myapp/auth"
"myapp/rbac"
)
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 图，再配合 _ 空导入或延迟初始化来拆解。
