`go install` 不生成 `bin` 文件，通常是因为项目未置于 `$gopath/src/` 的规范路径下，或未满足 `main` 包结构要求；本文详解 gopath 工作区约定、目录组织规范及正确安装命令。
在 Go 1.4（及更早版本，尤其是非模块时代）中，go install 能否成功生成可执行文件，严格依赖于代码所处的目录路径是否符合 GOPATH 工作区约定，而非仅由 package main 和 func main() 决定。
✅ 正确的项目结构是前提
Go 要求命令（command）程序必须位于 $GOPATH/src/<import-path>/ 下，其中 <import-path> 通常是具有语义的路径（如 github.com/username/project/cmd/appname），且该目录内需包含：
- 至少一个 .go 文件；
- 文件中声明 package main；
- 包内定义 func main() 函数。
例如，若希望生成 $GOPATH/bin/decerver，你的 main.go 必须位于：
$GOPATH/src/github.com/eris-ltd/decerver/cmd/decerver/main.go
而不是随意放在 ~/myproject/main.go 或 $GOPATH/src/main.go —— 后者因路径无有效导入路径，go install 将忽略它。
? 验证你的环境配置
你提供的 go env 输出中关键信息如下：
GOPATH="/home/jdevoo/Downloads/go" GOBIN="" # 注意：为空，表示将使用 $GOPATH/bin
这意味着 Go 会默认将编译出的二进制文件写入 /home/jdevoo/Downloads/go/bin/。请确认该目录存在且有写权限：
mkdir -p "$GOPATH/bin" ls -ld "$GOPATH/bin"
同时检查 $GOPATH/src/ 是否已创建，并将你的项目按规范放入其中：
# 正确做法示例（以 decerver 为例）： mkdir -p "$GOPATH/src/github.com/eris-ltd/decerver/cmd/decerver" cp /path/to/your/main.go "$GOPATH/src/github.com/eris-ltd/decerver/cmd/decerver/"
✅ 执行安装的正确方式
进入对应命令目录后运行（无需 -x -a，除非调试或强制重编）：
cd "$GOPATH/src/github.com/eris-ltd/decerver/cmd/decerver" go install
✅ 成功后，可直接运行：
$GOPATH/bin/decerver --help
? 提示：go install 默认只构建当前目录（即含 main 包的目录），不会递归扫描子目录；-a 强制重编所有依赖，耗时长且通常不必要；-x 仅打印构建命令，不改变输出行为。
⚠️ 常见误区与检查清单
- ❌ main.go 在 $GOPATH/src/ 根目录下 → 无效，无导入路径；
- ❌ GOPATH 未设置或指向错误路径 → go install 无处落脚；
- ❌ GOBIN 被设为不可写路径或权限不足 → 静默失败（可通过 strace go install 2>&1 | grep bin 排查）；
- ❌ 混淆 go build 与 go install：前者生成当前目录下的可执行文件，后者才写入 $GOBIN 或 $GOPATH/bin；
- ❌ 使用 Go 1.11+ 但未启用模块（go.mod）又误用旧 GOPATH 模式 → 建议统一升级并启用模块（go mod init），但注意：模块模式下 go install 行为略有不同（需带版本，如 go install .@latest）。
✅ 总结
go install 本质是一个“基于导入路径的构建+复制”工具。它不是通用编译器，而是 Go 工作流中连接源码位置与可执行输出的关键环节。只要确保：
- 项目置于 $GOPATH/src/<valid-import-path>/ 下；
- 目录内含合法 main 包；
- $GOPATH/bin 存在且可写；
- 在该目录下执行 go install（不加冗余标志）；
即可稳定生成预期的二进制文件。
