如何在 Go 项目中正确构建可执行二进制文件

go 中构建可执行文件的关键在于：源文件必须属于 package main，且至少包含一个 func main()；目录结构仅为组织便利，go 编译器不识别“子包”概念。

在 Go 语言中，go build 是否生成可执行二进制文件（如 sub1.exe），完全取决于代码的包声明和入口函数，而非文件名、目录位置或项目结构。你遇到“执行 go build 后无输出文件”的问题，根本原因极可能是：sub1/main.go 中未正确定义主程序包。

✅ 正确做法如下：

1. 确保 main.go 文件以 package main 开头

   // sub1/main.go
   package main
   
   import "fmt"
   
   func main() {
       fmt.Println("Hello from sub1!")
   }

2. 在对应目录下运行 go build

   cd src/github.com/user/project/sub1
   go build

   成功后将生成与目录名同名的可执行文件（Windows 下为 sub1.exe，Linux/macOS 下为 sub1）。

3. （可选）指定输出名称

   go build -o myapp.exe  # Windows
   go build -o ./bin/sub1  # 自定义路径与名称

⚠️ 常见误区提醒：

• ❌ package sub1 或 package utils 等非 main 包无法生成可执行文件——go build 会静默编译为 .a 归档（仅用于导入），不产生二进制。
• ❌ 文件名无关紧要（main.go、app.go、entry.go 均可），关键在 package main + func main()。
• ❌ Go 没有“subpackage”或“嵌套命令包”的概念；github.com/user/project/sub1 只是导入路径的一部分，对构建行为无特殊影响。
• ✅ 若项目使用 Go Modules（推荐），应在项目根目录初始化 go mod init github.com/user/project，并确保 GO111MODULE=on（Go 1.16+ 默认启用）。

? 进阶提示：若希望一键构建多个命令，可在项目根目录运行：

go build ./sub1 ./sub2  # 同时生成 sub1 和 sub2 可执行文件

或使用 go install（需配置 GOBIN）将二进制安装至全局路径。

总结：Go 的构建模型简洁而严格——

可执行性由语义（main 包 + main 函数）决定，而非文件系统布局。检查并修正包声明，即可让 go build 稳定产出预期的二进制文件。