go install生成的二进制文件默认存于$gobin（若设置）或$gopath/bin，需确保gobin/gopath有效、目录存在且可写，并满足项目位于$gopath/src/下的规范路径要求。
go install 生成的二进制文件到底去了哪儿
它默认不会出现在你当前目录，也不会自动出现在 PATH 里——而是由 GOBIN 和 GOPATH 共同决定。如果执行 go install 后找不到生成的文件，大概率是这两个变量没生效，或者路径根本不存在。
先运行 go env GOPATH GOBIN 看输出：
- 如果 GOBIN 是空字符串，Go 会退回到 $GOPATH/bin；
- 如果 GOPATH 也是空的，Go 可能尝试写入 $GOROOT 下（比如 /usr/local/go/bin），但普通用户没权限，结果静默失败或报 permission denied。
常见错误现象：
- go install 没报错，但 which yourcmd 找不到命令；
- ls $GOPATH/bin 返回空，甚至提示目录不存在；
- go install 报错 no install location for directory ... outside GOPATH。
GOBIN 必须指向一个真实存在的可写目录
GOBIN 不是“建议设置”，而是硬性前提：只要它被设了，Go 就严格往那写；如果路径不存在，go install 直接失败，报错类似 mkdir /nonexistent/bin: no such file or directory。
- Linux/macOS 推荐统一设为
$HOME/go/bin：mkdir -p $HOME/go/bin export GOBIN=$HOME/go/bin export PATH=$GOBIN:$PATH
- Windows PowerShell：
New-Item -ItemType Directory -Path "$HOME\go\bin" -Force $env:GOBIN="$HOME\go\bin" $env:PATH="$env:GOBIN;$env:PATH"
- 必须确保
$GOBIN目录存在且当前用户有写权限——go install不会自动创建父级目录。
go install 要求项目在 GOPATH/src 下才有意义
go install 不是编译当前目录，而是按 Go 工作区规则解析导入路径。即使 GOBIN 设置正确，如果 main.go 不在 $GOPATH/src/xxx 结构里，它压根不会生成二进制文件，也不报错。
验证方式：
- 运行 go list -f '{{.Name}}' .，输出必须是 main；
- 运行 go list -f '{{.Target}}' .，输出应为类似 /home/user/go/bin/mytool（即最终目标路径）。
典型结构要求：
- ✅ 正确：$GOPATH/src/github.com/you/tool/main.go → 安装后生成 $GOBIN/tool；
- ❌ 错误：~/project/main.go 或 /tmp/app/main.go → go install 无效果；
- ⚠️ 注意：go install 默认以最内层目录名为二进制名，不是包名、也不是导入路径全名。
GOBIN 和 GOPATH 的优先级与常见冲突
顺序很关键：
- 如果 GOBIN 非空，Go 完全忽略 GOPATH 的 bin 子目录；
- 如果 GOBIN 为空，Go 才用 $GOPATH/bin（取第一个 GOPATH 路径）；
- GOPATH 多值时（用冒号分隔），只影响 src 和 pkg 查找，bin 输出仍只走第一个路径下的 bin。
容易踩的坑：
- 在 .zshrc 里写了 export GOBIN=...，但忘了 source ~/.zshrc 或开了新终端；
- GOPATH 设了，但没建 bin 目录，又没设 GOBIN，导致 go install 写入失败却无提示；
- 用了 Go Modules（go.mod）后仍依赖 GOPATH 工作流，此时 go install 行为已变化——它支持模块路径安装，如 go install github.com/you/tool@latest，不再强制要求源码在 GOPATH/src 下。
真正麻烦的不是配置本身，而是环境变量是否被 shell 实际加载、路径是否存在、以及当前项目是否满足 Go 工作区语义——三者缺一不可。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
