Go无法找到本地包：构建项目时遇包查找错误求助

这问题我之前踩过坑，明明目标包就在$GOROOT对应的目录里，单独编译也没问题，但主项目就是找不到，咱们一步步拆解原因和解决办法：

核心原因：GOROOT的定位问题 #

Go官方设计中，$GOROOT是Go语言标准库的安装目录，并不推荐存放自定义业务代码。Go的包查找机制（尤其是启用Go Modules后）会优先忽略$GOROOT下的自定义包，只识别标准库代码。这就是为什么你单独编译models目录没问题，但主项目导入时会报错——单独编译时Go只处理当前目录的代码，而主项目编译时会严格遵循包查找规则。

具体解决办法 #

1. 迁移自定义包到正确路径（推荐） #

把models包从$GOROOT/src/github.com/user/projectname/models迁移到$GOPATH/src/github.com/user/projectname/models；如果你的主项目使用Go Modules，更推荐直接把models作为主项目的子目录（比如./models），然后导入路径改为你的主项目模块路径/models。

2. 用Go Modules的replace指令临时映射 #

如果暂时不想迁移包，可以在主项目的go.mod文件中添加replace指令，强制Go工具链到指定路径查找包：

replace github.com/user/projectname/models => /usr/local/go/src/github.com/user/projectname/models

添加后执行go mod tidy，让Go更新依赖映射关系。

3. 检查导入路径与环境变量一致性 #

• 确认导入语句的路径和实际目录完全一致（Go对路径大小写、拼写敏感，别犯低级错误）；
• 用go version和echo $GOROOT检查当前使用的Go版本与$GOROOT指向的版本是否匹配，避免版本不一致导致的路径识别问题。

4. 关闭Go Modules（仅临时调试用，不推荐） #

如果你的项目没有使用Go Modules，可以尝试设置环境变量GO111MODULE=off，同时确保$GOPATH设置正确。此时Go会优先从$GOPATH/src和$GOROOT/src查找包，但这种方式不符合Go现代开发规范，只适合临时排查问题。

内容的提问来源于stack exchange，提问作者noahgg