go build 仅在构建单个 main 包时生成可执行文件；若目标是非 main 包（如 dao.go），它只会编译检查并丢弃结果，不会产生任何输出文件。
`go build` 仅在构建**单个 main 包**时生成可执行文件；若目标是非 main 包（如 `dao.go`），它只会编译检查并丢弃结果，不会产生任何输出文件。
go build 是 Go 工具链中用于编译源码的核心命令，但其行为常被误解——它并非“总是生成可执行文件”，而是遵循明确的语义规则：仅当构建对象是一个可独立运行的 main 包时，才输出二进制文件；其余情况（如编译库包、多个包或非 main 包）仅执行编译验证，不保留产物。
✅ 正确使用场景：构建可执行程序
要生成可执行文件，必须确保：
- 当前目录（或指定路径）下存在一个且仅有一个 main 包；
- 该包中包含 func main() 函数；
- go build 的参数指向该 main 包所在目录或 .go 文件（推荐目录方式）。
# ✅ 正确：当前目录含 main.go（package main + func main） $ go build $ ./myapp # 生成默认名称的可执行文件 # ✅ 正确：显式指定 main 包文件（仍需是 main 包） $ go build main.go $ ./main # ✅ 正确：指定输出路径 $ go build -o ./bin/app main.go
❌ 常见误解：尝试构建非 main 包
以下操作不会生成任何文件，但会静默成功（除非代码有错）：
# ❌ dao.go 属于普通包（如 package dao），无 main 函数 $ go build dao.go # 编译通过，但无输出文件 $ ls # 看不到 dao 或任何新文件 # ❌ 多个非 main 文件（即使含 main.go，但同时指定其他包） $ go build main.go dao.go utils.go # 若 dao/utils 非 main 包，则整体视为“非单一 main 包”，不生成输出
⚠️ 注意：go build 不支持直接导出 .a 归档文件或 .so 共享库——这是 go install（配合 GOBIN）或 go build -buildmode= 的职责。例如：
# 生成安装到 $GOPATH/bin 的可执行文件（等效于 go install） $ go install . # 构建为静态链接库（.a） $ go build -buildmode=archive -o dao.a dao.go
? 如何验证包类型？
快速确认一个文件是否属于 main 包：
// dao.go
package dao // ← 这不是 main 包，无法通过 go build 直接生成可执行文件
func Save() { /* ... */ }// main.go
package main // ← 必须是 main
import "fmt"
func main() {
fmt.Println("Hello, World!")
}✅ 替代方案：当你需要复用 dao.go 等模块
- 将 dao.go 放入独立子目录（如 ./dao/），保持 package dao；
- 在 main.go 中导入：import "your-module/dao"；
- 运行 go build 于 main.go 所在目录 —— dao 会被自动编译并链接进最终二进制。
总结
| 场景 | go build 行为 | 输出文件？ |
|---|---|---|
| 单个 main 包（目录或 main.go） | 编译并写入可执行文件 | ✅ 默认名（目录名）或 -o 指定名 |
| 单个非 main 包（如 dao.go） | 编译检查，丢弃结果 | ❌ 无输出 |
| 多个包混合（含 main.go + dao.go） | 若非单一 main 包上下文，不生成可执行文件 | ❌（除非仅 main 包被识别） |
牢记：go build 的设计哲学是 “构建即运行” —— 它面向终端可执行体，而非通用编译器。需要构建库、安装工具或定制输出，请转向 go install、go build -buildmode 或模块化组织结构。
