早上拉完代码 go build ./... 直接失败,输出 ./main.go:31:14: undefined: models.User。models 包里 User 这个结构体明明在,我前一天还往里加了个字段。
undefined 在 Go 里只有几种来路:标识符首字母小写没导出、包名和目录名对不上、import 路径指到了另一个同名包、文件被 build tag 排除了。它跟循环引用没关系。真出现循环引用,编译器报的是 import cycle not allowed,还会把整条链打出来,形如 a -> b -> a,不会伪装成 undefined。
先确认编译到的是哪个目录:go list -f '{{.Dir}} {{.Name}}' ./models。输出里 Dir 正常,Name 却是 model,少了个 s。
go list -f '{{.Dir}} {{.Name}}' ./models
# /data/app/models model
grep -rn '^package ' models/
# models/user.go:package model
go build ./...
原因就是新加的 user.go 里 paCkage 写成了 model。同一个目录下两个包名,go list 只报一个,构建时这个文件被排除在外,User 自然就成了 undefined。改回 package models 之后编译通过。这条错误一般还会伴随 found packages models and model 的提示,但那是直接编译该目录时才出现的,从上层 ./... 编的时候我这边没看到。
另一种情况遇到过:项目里有 vendor 目录,改了 go.mod 却没跑 go mod vendor,编译用的是旧 vendor 里的包,报的也是 undefined。加 -mod=mod 再编一次错误就消失,等于确认了方向。
现在改完代码第一件事是 go list 看包名,然后才 go build。那个 models 目录后来进了 CI 检查,grep 出目录下所有 package 声明,不一致就拦下来,省得下次再翻半小时。
