go build生成可执行文件到当前目录，不修改PATH；go install则安装到$GOBIN（默认$HOME/go/bin），要求模块路径合法且包为main，确保全局可用。
go build 和 go install 到底该用哪个
构建 Go 命令行工具时，go build 和 go install 行为差异明显，选错会导致二进制找不到或路径混乱。
go build 默认把可执行文件生成在当前目录，不自动加入 PATH；go install 则强制安装到 $GOBIN（默认是 $HOME/go/bin），且要求模块路径（module 声明）合法——否则会报错 cannot install non-main package。
- 调试阶段用
go build -o ./bin/mycmd ./cmd/mycmd，快速生成并手动运行 - 批量构建所有命令（如
cmd/serve、cmd/migrate）直接跑go install ./...，不用写死路径 - 如果
go install ./报错 “no Go files in …”，说明某个cmd/*/下没有main.go或包声明不是package main - Go 1.21+ 默认启用
GOPATH模式关闭，$GOBIN必须在$PATH中才可直接调用生成的命令
构建多命令项目时为什么 go build ./ 不推荐
go build ./ 会为每个子目录生成一个同名可执行文件，但行为不可控：它只扫描「当前目录下一级」的包，不会递归进 cmd/serve/ 这类嵌套结构；更糟的是，它会在每个包目录里生成二进制，污染源码树。
比如项目结构是 cmd/serve/main.go，go build ./ 在根目录执行后，会在 ./cmd/serve/ 下生成 serve 文件——这不是你想要的部署方式。
立即学习“go语言免费学习笔记（深入）”；
- 正确做法是明确指定目标：
go build -o ./bin/serve ./cmd/serve - 或者用
go install配合模块路径：确保go.mod里module值合理（如example.com/myapp），再运行go install ./cmd/... - 若用 Makefile 封装，别写
go build ./，改用go list -f '{{.ImportPath}}' ./cmd/...动态获取包路径再构建
跨平台构建时 -ldflags 和 GOOS/GOARCH 的坑
用 GOOS=windows GOARCH=amd64 go build 能交叉编译，但容易忽略两个关键点：标准库依赖和 -ldflags 中的版本信息注入。
例如加了 -ldflags="-X main.version=1.0.0"，如果 main.version 对应的变量不在被构建的 main 包里（比如写在 internal/version/version.go 里但没被 import），链接会静默失败，生成的二进制里版本号仍是空字符串。
- 确保
-X引用的包路径与实际 import 路径完全一致，比如-X github.com/yourname/myapp/internal/version.Version=1.0.0 -
GOOS设为windows时，输出文件默认带.exe后缀；设为linux或darwin则无后缀，别硬编码-o myapp.exe - 静态链接（避免 libc 依赖）要加
-ldflags '-extldflags "-static"'，但仅对 Linux 有效，macOS 和 Windows 不支持
为什么 go run cmd/xxx/main.go 有时不生效
常见原因是当前目录下存在 go.mod，但模块路径（module 行）写成了相对路径或非法格式，比如 module . 或 module mytool。Go 会拒绝运行非规范模块下的 main 包，报错 go: cannot find main module。
另一个隐蔽问题是 main.go 里 import 了本模块内其他包，而那些包的 import path 与 go.mod 中声明的 module 不匹配——例如 go.mod 写 module example.com/app，但代码里写了 import "app/internal/config"，就会导致找不到包。
- 检查
go.mod第一行：必须是类似module github.com/user/repo的完整路径，不能是单个词 - 运行前先执行
go list -m确认模块已识别；再用go list -f '{{.Dir}}' ./cmd/xxx验证路径是否被正确解析 - 临时调试可用
cd cmd/xxx && go run main.go，绕过根目录模块上下文（但仅限简单场景）
go install 失效、go run 找不到包、CI 构建失败，且错误提示极其模糊。 
