go跨平台交叉编译需同时设置goos和goarch，cgo_enabled=0适用于纯go项目，启用cgo则必须配置对应平台c工具链及sysroot路径，否则会静默降级或编译失败。
Go 本身不依赖外部 SDK 或交叉工具链就能做跨平台编译，只要 GOOS 和 GOARCH 同时设对、CGO_ENABLED 控制得当，就能在 macOS 上直接生成 Linux ARM64 的二进制——但很多人卡在 build constraints 报错或生成的 Windows 程序双击无响应，问题往往出在环境变量污染或 CGO 误启上。
GOOS 和 GOARCH 必须成对设置，不能只改一个
单独 export GOOS=linux 而不设 GOARCH，Go 会沿用当前宿主机的 GOARCH（比如 darwin/amd64），结果可能生成一个 linux/amd64 二进制——但它在 macOS 上根本跑不起来，还容易被误认为“编译成功”。
-
go tool dist list可查所有合法组合，比如linux/arm64、windows/amd64、darwin/arm64（Go 1.21+ 才正式支持） - Windows 目标必须加
.exe后缀，否则系统不识别为可执行文件 - ARMv7 需额外设
GOARM=7，仅GOARCH=arm不够 - Mac M1/M2 编译本地 darwin/arm64 无需额外配置；但编译 darwin/amd64 时，若 Go
CGO_ENABLED=0 是默认安全起点，但不是万能解药
设 CGO_ENABLED=0 能绕过 C 工具链缺失问题，生成完全静态二进制，适合纯 Go 项目（没 import "C"、没 // #cgo、没调用 os/user 或 net 中的 DNS 原生实现）。但一旦用了 github.com/mattn/go-sqlite3 或 golang.org/x/sys/unix，就会编译失败或运行时 panic。
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。
- 错误现象：
build constraints exclude all Go files往往是因为代码里有// +build windows，而你设了GOOS=linux，整个文件被跳过 - 更隐蔽的坑：CGO_ENABLED=1 是默认值，但没配好 C 工具链时，Go 会静默降级为 0，不报错也不提醒——结果功能缺失却查不出原因
- 验证是否真启用了 CGO：加
-x参数看构建日志，搜gcc行，确认调用的是你指定的交叉编译器（如aarch64-linux-gnu-gcc）
带 CGO 的交叉编译必须配 C 工具链，不能只靠环境变量
只设 CGO_ENABLED=1 GOOS=linux GOARCH=arm64 没用。Go 会去调用 gcc，但宿主机的 gcc 是 x86_64-linux-gnu-gcc，它没法生成 arm64 代码。
- Linux 下装交叉工具链：
sudo apt install gcc-aarch64-linux-gnu g++-aarch64-linux-gnu - 然后显式指定：
CC=aarch64-linux-gnu-gcc CGO_ENABLED=1 GOOS=linux GOARCH=arm64 go build -o app main.go - 别漏
CGO_CFLAGS和CGO_LDFLAGS：比如CGO_CFLAGS="--sysroot=/usr/aarch64-linux-gnu" CGO_LDFLAGS="-L/usr/aarch64-linux-gnu/lib"，否则会报fatal error: stdio.h: No such file or directory - Windows 上原生编译 Linux 二进制极不可靠，推荐用 WSL2 或 Docker：
docker run --rm -v $(pwd):/app -w /app arm64v8/alpine go build -o app main.go
避免 shell 环境污染，用 env 前置最稳妥
在 CI 或多项目共存的终端里，用 export GOOS=xxx 后再 go build，极易污染后续命令。尤其 zsh 用户，历史里的 export 可能残留几小时。
- 正确写法：
env GOOS=linux GOARCH=arm64 CGO_ENABLED=0 go build -o bin/app-linux-arm64 . - 错误写法：
export GOOS=linux; go build -o app .—— 这会让接下来所有go命令都按 linux 构建，直到手动 unset - 自动化脚本里务必用子 shell 封装，或每次用
env显式传参，别依赖全局环境变量 - Windows PowerShell 用户注意语法差异：
$env:GOOS="linux"; $env:GOARCH="amd64"，但依然建议统一用env命令兼容性更好
真正容易被忽略的不是参数怎么写，而是资源路径和动态依赖不会随二进制一起打包——比如 config.yaml、templates/ 目录、或者 SQLite 的 so 文件，这些必须手动分发，且路径要硬编码或通过 flag 注入，不能依赖当前工作目录。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
