LoongArch64交叉编译必须使用Go 1.20+，需显式设置CC_loong64=loongarch64-linux-gnu-gcc并保持CGO_ENABLED=1，禁用CGO会导致DNS、用户查询等功能异常，推荐go build -ldflags="-s -w" -trimpath。
LoongArch64交叉编译必须用Go 1.20+
低于Go 1.20的版本对LoongArch64支持不完整，编译时大概率报build constraints exclude all Go files或unknown architecture "loong64"。Go 1.19仅做实验性支持，标准库中net、os/user等包在loong64下会因CGO依赖缺失而构建失败。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 从
https://go.dev/dl/下载go1.20.15.linux-amd64.tar.gz或更高稳定版（截至2026年7月，推荐1.22.x） - 解压后替换
/usr/local/go，并确保go version输出含go1.20或更新字样 - 不要用系统包管理器安装的Go（如Ubuntu apt源中仍是1.19），它无法满足loongarch64最低要求
交叉编译工具链必须显式指定cc且路径正确
即使设置了GOOS=linux GOARCH=loong64，若未配置CC环境变量，Go仍会尝试调用宿主机默认gcc，导致链接阶段失败，错误类似：cannot execute binary file: Exec format error或undefined reference to `__stack_chk_fail'。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- Debian/Ubuntu用户安装：
sudo apt install gcc-loongarch64-linux-gnu g++-loongarch64-linux-gnu - 验证路径：
which loongarch64-linux-gnu-gcc应返回/usr/bin/loongarch64-linux-gnu-gcc - 编译前必须导出：
CC_loong64=loongarch64-linux-gnu-gcc（注意变量名带架构后缀） - 完整命令示例：
CGO_ENABLED=1 GOOS=linux GOARCH=loong64 CC_loong64=loongarch64-linux-gnu-gcc go build -o app-loong64
CGO_ENABLED=0不是万能解，LoongArch64上慎用
很多教程盲目推荐CGO_ENABLED=0来“规避工具链问题”，但在LoongArch64上会导致标准库功能降级：DNS解析走纯Go实现（慢且不支持/etc/resolv.conf的search域）、user.Lookup返回空、exec.LookPath无法识别PATH中二进制——这些在龙芯服务器生产环境中极易引发隐蔽故障。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 优先保持
CGO_ENABLED=1，只在确认代码完全不调用C库时才设为0 - 若必须禁用CGO，需手动补全行为：用
net.DefaultResolver硬编码DNS、用os.Getenv("HOME")替代user.Current() - 静态链接风险：
CGO_ENABLED=0虽生成纯静态二进制，但LoongArch64的glibc版本差异可能导致运行时报symbol lookup error，尤其在CentOS Stream 8+或Loongnix上
编译参数要加-ldflags="-s -w"但避开-a
-a参数在Go 1.12后已被废弃，强制全量重编译所有依赖包，不仅拖慢构建（尤其含cgo的项目），还会绕过编译缓存，使GOCACHE失效。而-ldflags="-s -w"可安全裁剪调试符号和DWARF信息，在LoongArch64上平均减小二进制体积12%～18%，对嵌入式部署很关键。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
go build -ldflags="-s -w" -o app代替go build -a -ldflags="-s -w" - LoongArch64目标机内存通常有限，建议额外加
-trimpath消除绝对路径信息，提升可移植性 - 避免在CI脚本中写死
GOARM或GO386等无关变量——它们对loong64无效，反而干扰环境判断
CC_loong64变量名中的下划线和架构名大小写——写成CC_loong64或CC_LOONG64都会静默失效。 
