go build 默认动态链接依赖系统 libc，跨平台或精简环境需禁用 cgo 并静态编译：cgo_enabled=0 go build -ldflags '-s -w'；交叉编译必须关 cgo；cli 工具应使用 cobra 管理命令，配合 go mod 初始化和 vendor 保障可复现构建。
go build 默认是动态链接，不是静态编译
直接执行 go build main.go 生成的二进制文件在 Linux 上依赖系统 libc（如 glibc），放到 Alpine 或某些精简容器里会报 standard_init_linux.go:228: exec user process caused: no such file or directory —— 这不是路径错了，而是动态链接器找不到。Windows/macOS 表现不同，但原理一致：默认不打包 C 运行时。
要真正“一键分发、开箱即用”，必须显式启用静态链接：
- Linux 下加
-ldflags '-s -w -linkmode external -extldflags "-static"'（仅限 cgo 启用时，且需主机有 static libc） - 更通用、更可靠的做法是禁用 cgo：
CGO_ENABLED=0 go build -ldflags '-s -w' main.go -
-s去除符号表，-w去除 DWARF 调试信息，两者合起来可减小体积 30%~50%
GOOS/GOARCH 交叉编译前必须关掉 CGO_ENABLED
想在 macOS 上编译 Linux 二进制？或在 Windows 上生成 arm64 Linux 可执行文件？直接设 GOOS=linux GOARCH=arm64 go build 会失败，报错类似 cross-compilation not enabled for package unsafe 或链接失败 —— 根本原因还是 cgo 在跨平台时无法自动匹配目标平台的 C 工具链。
正确做法只有一条：所有交叉编译场景下，强制关闭 cgo：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o mytool-linux-amd64 main.goCGO_ENABLED=0 GOOS=windows GOARCH=386 go build -o mytool-win32.exe main.go- 若代码里用了
os/user、net等包，它们在CGO_ENABLED=0下会自动回落到纯 Go 实现，功能不变，只是 DNS 解析可能走 TCP 而非系统 stub resolver
go mod init 和 vendor 不是可选项，而是命令行工具的交付前提
你写的命令行工具一旦要给别人用，就不能靠 go run 或裸 go build 临时凑合。没有 go.mod，别人 go get 你的项目时会拉取 master 最新 commit，版本不可控；没 go mod vendor，CI 构建或离线环境就可能失败。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
初始化和锁定依赖的最小闭环是：
- 项目根目录执行
go mod init github.com/yourname/mytool（模块名建议用真实 GitHub/GitLab 路径） - 首次构建后立即运行
go mod tidy清理未引用依赖、补全间接依赖 - 如需 vendor 到本地（例如企业内网 CI），执行
go mod vendor，之后构建加-mod=vendor参数：CGO_ENABLED=0 go build -mod=vendor -o mytool main.go
main 函数入口和 CLI 参数解析别硬写 flag 包原始接口
很多新手在 main() 里直接用 flag.String、flag.Parse() 拼参数，结果发现子命令支持弱、help 输出丑、类型转换易错。这不是 flag 包不行，而是过早接触底层 API 容易卡在“能跑”但“难维护”阶段。
推荐立刻切到成熟 CLI 库，比如 spf13/cobra：
- 它天然支持嵌套子命令（
mytool server start）、自动 help/usage 生成、bash/zsh 补全注册 - 初始化只需
curl -sS https://raw.githubusercontent.com/spf13/cobra/master/cobra.sh | bash，再cobra init+cobra add serve - 所有命令逻辑隔离在各自
cmd/serve.go文件里，main.go只剩一行：cmd.Execute()
静态打包时，cobra 不引入 cgo，CGO_ENABLED=0 下完全兼容，也不增加二进制体积——这点常被忽略，但恰恰是 CLI 工具长期可维护的关键。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
