定位 import cycle 需用 go list -f '{{.ImportPath}} -> {{join .Imports " -> "}}' ./ 或 go mod graph | grep -E 'pkgA|pkgB' 查闭环，特别注意 _test.go 和 //go:embed 生成代码中的隐式依赖。
go build 报 import cycle not allowed 怎么定位回边
Go 编译器只报错不指路，import cycle not allowed 这类错误必须靠工具挖路径。最有效的是用 go list 生成导入图再过滤：
- 运行
go list -f '{{.ImportPath}} -> {{join .Imports " -> "}}' ./，输出所有包的导入链；用grep搜两个可疑包名，比如grep -E 'user|repo'，看是否出现user -> repo -> user这种闭环 - 更省事的是
go mod graph | grep -E 'pkgA|pkgB'，直接筛出含这两个包的边，一眼识别回边 - 别忽略
_test.go文件——测试文件里 import 了model，而model又 import 了testutil（被生产代码引用），这种隐式环最难发现 -
//go:embed或//go:generate生成的代码如果反向 import 了源包，也会触发循环，检查生成后的.go文件内容
undefined type / undefined method / undefined constant 都指向同一个根因
这类 “undefined X” 错误表面是类型/方法/常量找不到，本质通常是包依赖断裂或作用域失效，不是语法写错了：
-
undefined type：先确认该类型定义所在的包是否被正确 import；再检查有没有循环 import 导致编译器提前放弃解析；标准库类型如sync.WaitGroup报这个错，90% 是漏写了import "sync" -
undefined method：不是方法没实现，而是调用方持有的变量类型不对——比如你传了个*User却想调User接口的方法，或接口定义在 A 包，但 B 包实现了它却没 import A -
undefined constant：常量拼写大小写错（Go 区分大小写）、定义在其他文件但没加export（首字母小写）、或常量所在包没被 import；跨文件使用时尤其注意作用域和包别名
go run main.go 报 no required module provides package 怎么救
这不是代码问题，是模块上下文缺失。Go 1.16+ 默认启用 Modules，没有 go.mod 就拒绝识别任何 import 路径：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 进项目根目录（就是你放
main.go的那个空文件夹），执行go mod init example.com/myapp，模块名随意，不需真实域名 - 生成
go.mod后再跑go run main.go，此时 Go 才会把当前目录当模块根，解析相对 import 路径 - 别把项目建在
$GOPATH/src下硬套旧结构——Modules 模式下项目可放在任意路径，$GOPATH只管go install输出的二进制 - 如果 import 了第三方包（如
github.com/gin-gonic/gin），首次运行会自动下载并写入go.mod和go.sum，网络卡住就配 GOPROXY
CGO_ENABLED=0 不是可选项，是跨平台编译的必填项
从 macOS 编译 Linux 二进制却提示 cannot execute binary file: Exec format error，基本就是 CGO 没关：
立即学习“go语言免费学习笔记（深入）”；
-
CGO_ENABLED=0必须显式设，不能依赖默认；否则 Go 会链接目标平台 C 库，导致二进制不可移植 - 命令格式：Linux/macOS 用
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o app-linux main.go；Windows CMD 用set CGO_ENABLED=0 && go build -o app.exe main.go -
GOOS和GOARCH必须成对出现，单独设一个无效；常见组合：GOOS=windows GOARCH=386、GOOS=darwin GOARCH=arm64 - Windows 上编译的 exe 双击闪退，大概率也是 CGO 引起的 DLL 缺失，
CGO_ENABLED=0是最快解法
循环依赖和模块上下文缺失是高频痛点，但真正难缠的是那些“看起来没动过”的地方——测试文件、embed 生成代码、包别名拼写、甚至 IDE 缓存。排查时别只盯报错行，得顺着 import 链往回翻两层。
