Go语言编译多文件main包必须显式指定所有.go文件，如go build main.go api.go；推荐用go build .自动编译当前目录非测试文件，避免undefined类型或multiple main错误。
go build 编译多个 .go 文件必须显式列出所有文件
Go 不像 Java 或 Python 那样自动扫描目录下所有源文件。当你用 go build 编译一个含多个文件的 main 包时，必须把每个 .go 文件都写进命令里，否则会报 main redeclared in this block 或 undefined: xxx。
常见错误现象：
- 只运行
go build main.go，但项目里还有utils.go和handler.go—— 编译通过但运行时报函数未定义 - 误以为
go build ./cmd能递归编译子目录 —— 实际上它只会找该目录下的main.go，其他文件被忽略
正确做法：
- 确保所有属于同一
main包的文件都在同一目录下（如都放在./） - 显式列出全部文件：
go build -o myapp main.go utils.go handler.go - 若文件太多，可用 shell 展开：
go build -o myapp *.go（仅限当前目录，且不含子目录）
GOOS 和 GOARCH 环境变量控制跨平台编译结果
Go 原生支持交叉编译，但默认生成的是当前系统的可执行文件。想生成 Windows 版本却在 macOS 上执行 go build，结果仍是 macOS 二进制 —— 这是新手最常踩的坑。
立即学习“go语言免费学习笔记（深入）”；
关键点：
-
GOOS指定目标操作系统（linux、windows、darwin） -
GOARCH指定目标架构（amd64、arm64、386） - 组合必须合法，可用
go tool dist list | grep linux查看支持列表 - Windows 输出需加
.exe后缀，其他系统不需要
示例：
GOOS=windows GOARCH=amd64 go build -o app.exe main.go utils.goGOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -a -o app-linux-arm64 main.go *.go
注意：CGO_ENABLED=0 是静态编译的关键，避免运行时依赖 libc 等动态库，否则跨平台后可能无法启动。
go run 只能用于单目录内快速验证，不适用于多包协作
go run 看似方便，但它本质是「临时构建 + 执行」，且只接受当前目录或显式指定的 .go 文件列表。一旦项目拆分成多个包（比如 main 包调用 internal/service），go run 就会失败。
典型错误：
-
go run .报错cannot load internal/service: cannot find module providing package internal/service -
go run main.go提示undefined: service.DoSomething，因为没包含service/xxx.go
这时必须用模块方式管理：
- 项目根目录执行
go mod init example.com/myapp - 确保所有子包路径符合 Go Module 规则（如
internal/service必须在./internal/service/目录） - 编译统一用
go build，而不是go run
简单说：go run 是玩具，go build + go mod 才是生产方案。
GOPROXY 和 GO111MODULE 必须提前设置，否则依赖拉取大概率失败
国内用户不设 GOPROXY，go build 或 go get 会卡在 Fetching github.com/sirupsen/logrus，甚至超时退出。这不是网络问题，而是默认代理 https://proxy.golang.org 在大陆不可达。
解决方案（立即生效）：
- Linux/macOS：
go env -w GOPROXY=https://goproxy.cn,direct - Windows PowerShell：
go env -w GOPROXY=https://goproxy.cn,direct - 同时启用模块：
go env -w GO111MODULE=on
验证是否生效：
- 执行
go env GOPROXY，输出应为https://goproxy.cn,direct - 新建空目录，运行
go mod init test && go get github.com/gin-gonic/gin@v1.9.0，几秒内完成即成功
容易被忽略的一点：即使你只编译本地代码、不引入任何第三方库，只要项目用了 go.mod，go build 仍会尝试检查模块完整性 —— 此时若 GOPROXY 不通，依然会失败。
