Go跨平台交叉编译成功的关键是同时显式设置GOOS和GOARCH并关闭CGO_ENABLED=0；漏设任一变量或启用CGO，易导致目标机器报cannot execute binary file或no such file or directory。
Go 环境能跑 go run 不代表适合生产部署；跨平台编译失败，90% 是因为没关 CGO_ENABLED 或没设对 GOOS/GOARCH。
go version 能输出就说明环境装好了？别急着写代码
很多新手看到 go version 返回正常就以为万事大吉，其实只是 GOROOT 没问题，GOPATH 和模块初始化可能还空着。尤其在 Go 1.16+ 默认启用 Go Modules 后，GOPATH 已非必需，但 go mod init 漏掉会导致依赖无法解析。
- 执行
go env GOPATH看路径是否合理（比如不是/root/go这类权限敏感位置） - 新建项目目录后，必须运行
go mod init example.com/myapp，否则go get会报working directory is not part of a module - 国内用户务必设置代理，否则
go mod download极大概率卡住：go env -w GOPROXY=https://goproxy.cn,direct - 验证模块功能：写个带第三方包的
main.go（比如import "github.com/gorilla/mux"），再执行go build—— 成功才真通了
Linux 服务器上跑不起来本地编译的二进制？检查这三件事
你在 macOS 或 Windows 上 go build 出来的文件，直接扔到 Linux 服务器上执行报 cannot execute binary file: Exec format error，不是权限问题，是架构不匹配。
- 确认目标服务器 CPU 架构：
uname -m（常见为x86_64或aarch64） - 本地编译时显式指定目标平台：
GOOS=linux GOARCH=amd64 go build -o myapp（注意GOARCH=amd64对应x86_64，不是arm64） - 必须关闭 CGO：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp—— 否则会静态链接失败或引入 host 系统的 libc 依赖 - 加
-ldflags "-s -w"可减小体积（去掉调试符号和 DWARF 信息），对 Docker 镜像尤其有用
nohup 启动后进程秒退？日志和工作目录常被忽略
nohup ./myapp & 看似启动成功，但 ps 查不到进程，根本原因是程序启动时读配置失败或监听端口被占，而错误全被 nohup 重定向到 nohup.out 里没人看。
立即学习“go语言免费学习笔记（深入）”；
- 先手动运行一次：
./myapp config.yaml，观察终端报错（比如open config.yaml: no such file or directory） - nohup 默认把当前目录当工作目录，但你上传二进制时很可能没同步配置文件 —— 建议用绝对路径启动：
nohup /data/app/myapp /data/app/conf/config.yaml > /data/app/logs/app.log 2>&1 & - 如果程序依赖相对路径的模板或静态资源，启动前用
cd /data/app && nohup ./myapp ...显式切换工作目录 - 更稳妥的做法是用 systemd 管理，避免 nohup 的信号处理缺陷（比如 SIGHUP 不一定转发）
部署后访问 503 或连接拒绝？检查监听地址和防火墙
程序明明跑起来了，ps aux | grep myapp 也能看到进程，但 curl localhost:8080 返回 connection refused，大概率是监听配置不对。
- Go 默认
http.Listen(":8080")绑定的是127.0.0.1:8080（仅本地），要对外服务得改成http.Listen("0.0.0.0:8080") - Linux 服务器默认开启 firewalld 或 ufw，即使程序监听了
0.0.0.0，端口也可能被拦截：sudo firewall-cmd --permanent --add-port=8080/tcp && sudo firewall-cmd --reload - 云服务器（如阿里云、腾讯云）还有安全组规则，需额外放行对应端口
- 用
netstat -tuln | grep :8080确认监听地址是否为*:8080，而不是127.0.0.1:8080
跨平台编译不是“换个参数就能跑”，它本质是构建一个与目标系统 ABI 兼容的独立二进制 —— 任何路径、网络、文件操作的假设都得在目标环境里成立。最常被跳过的一步：在目标服务器上 file ./myapp 看 ELF 架构，比盲猜靠谱得多。
