GOPATH 模式下不能直接在任意目录 go build，因为代码必须置于 $GOPATH/src/ 下且 import 路径须与磁盘路径严格一致；否则报 cannot find package 或 no Go files；手动组织多项目需按 import 路径结构放入 $GOPATH/src/，并确保 GO111MODULE=off。
GOPATH 模式下为什么不能直接在任意目录 go build
因为 GOPATH 模式要求所有代码必须放在 $GOPATH/src/ 下，且包路径（import 路径）必须与磁盘路径严格一致。比如你写了 import "myapp/handler"，Go 就会去 $GOPATH/src/myapp/handler/ 找，而不是当前目录。直接在桌面或 /tmp 里 go build 会报 cannot find package 或 no Go files in current directory —— 不是命令错了，是根本没进工作区。
如何手动组织多个项目到同一个 GOPATH
核心是让每个项目的根目录对应一个完整的 import 路径，且全部落在 $GOPATH/src/ 下。例如：
- 设
export GOPATH=$HOME/go（别用 root 或系统路径） - 项目 A 的 import 前缀是
github.com/user/proj-a→ 放到$HOME/go/src/github.com/user/proj-a/ - 项目 B 用私有路径
corp/internal/api→ 放到$HOME/go/src/corp/internal/api/ -
go install生成的二进制会落到$GOPATH/bin/，记得把该路径加进$PATH
注意：go get 会自动按 import 路径创建子目录，但只适用于能解析的远程路径（如 github.com/...），对 corp/... 这类本地路径无效，得手动建目录再放代码。
常见错误：go run main.go 报 cannot load xxx: cannot find module providing package
这是 GOPATH 模式被意外绕过的表现——通常因为你当前目录不在 $GOPATH/src/ 下的合法包路径里，或者环境变量 GO111MODULE 被设成了 on（强制启用模块模式）。检查：
立即学习“go语言免费学习笔记（深入）”；
- 运行
echo $GOPATH和pwd，确认当前路径以$GOPATH/src/xxx开头 - 运行
go env GO111MODULE，如果输出on，临时关掉：GO111MODULE=off go run main.go - 别在项目根目录下放
go.mod文件，它会让 Go 忽略 GOPATH
为什么现在不推荐继续用 GOPATH 模式管理新项目
不是因为它“错”，而是它和现代协作习惯冲突：
- 无法锁定依赖版本，
go get总拉最新版，CI 构建可能突然失败 - 多个项目共用
$GOPATH/pkg/缓存，A 项目升级某个包，B 项目go build可能静默使用新版，行为不一致 - 团队新人必须统一配置
GOPATH，还要记住“代码只能放 src 下”，而模块模式只要go mod init就能开干
如果你维护的是 Go 1.11 之前的遗留项目，或内网离线环境没有代理无法走模块代理，那 GOPATH 模式仍是务实选择；但凡能升级，优先用 go mod —— 它不排斥 GOPATH，只是不再依赖它。
