当 `go build` 报错 “c source files not allowed when not using cgo” 时，通常是因为环境变量 `goroot` 错误指向了非当前 go 安装路径（如旧版本或源码编译目录），导致 go 工具链误加载含 c 文件的 runtime 源码。解决方法是清除或修正 `goroot`。
该错误并非由项目代码引起，而是 Go 构建工具链在初始化时意外进入了包含 .c 文件的 Go 源码目录（例如 $GOROOT/src/runtime/ 下的 atomic_amd64x.c、os_linux.c 等）。标准 Go 发行版（二进制安装包）的 src/runtime/ 目录中不含 C 源文件——这些仅存在于 Go 的源码仓库（如 git clone https://go.googlesource.com/go）中。因此，当你看到此错误，几乎可以确定：GOROOT 被手动设置，且其值指向了一个 Go 源码树（而非官方二进制安装路径），而 Go 命令在该路径下尝试编译时，因未启用 cgo（默认禁用）而拒绝处理 C 文件。
✅ 正确做法是：让 Go 自动推导 GOROOT，而非手动设置。
Go 工具链（go 命令）在安装后能根据自身二进制位置自动定位标准库和运行时源码（例如 /usr/local/go 或 $HOME/sdk/go），无需且不应设置 GOROOT ——除非你有特殊需求（如多版本共存且需显式切换）。
? 验证与修复步骤：
-
检查当前 GOROOT：
echo $GOROOT # 若输出非空（如 /home/user/go 或 /usr/lib/go-1.2），即为问题根源
-
临时清除并测试：
unset GOROOT go env GOROOT # 应输出自动推导的正确路径，如 /usr/local/go go build # 此时应正常通过
-
永久移除（推荐）：
编辑你的 shell 配置文件（如 ~/.bashrc、~/.zshrc），删除或注释掉类似 export GOROOT=... 的行，然后重载：source ~/.bashrc
⚠️ 注意事项：
- 不要将 GOROOT 指向 Go 源码目录（如 ~/go/src），那是 GOPATH（旧版）或 GOWORK（Go 1.18+）的范畴；GOROOT 仅用于 Go SDK 安装根目录（只读）。
- 若你确实需要多版本管理，建议使用专用工具（如 gvm 或 goenv），它们会安全地切换 GOROOT 并隔离环境。
- 卸载旧版 Go 后残留的环境变量是常见“隐形陷阱”，apt autoremove 不会清理用户手动添加的 export 语句。
? 总结：Go 的设计哲学是“约定优于配置”。绝大多数场景下，GOROOT 应保持未设置状态，由 go 命令自主解析。一旦出现此类 C 文件报错，第一反应应是检查 GOROOT 是否被污染——90% 的案例由此引发。
