Golang环境搭建与跨终端编译部署全攻略-Golang-PHP中文网

go跨平台交叉编译成功的关键是同时显式设置goos和goarch并关闭cgo_enabled=0；漏设任一变量或启用cgo，易导致目标机器报cannot execute binary file或no such file or directory。

golang环境搭建与跨终端编译部署全攻略

Go 环境能跑 go run 不代表适合生产部署；跨平台编译失败，90% 是因为没关 CGO_ENABLED 或没设对 GOOS/GOARCH。

很多新手看到 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 —— 成功才真通了

你在 macOS 或 Windows 上 go build 出来的文件，直接扔到 Linux 服务器上执行报 cannot execute binary file: Exec format error，不是权限问题，是架构不匹配。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

确认目标服务器 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 ./myapp & 看似启动成功，但 ps 查不到进程，根本原因是程序启动时读配置失败或监听端口被占，而错误全被 nohup 重定向到 nohup.out 里没人看。

先手动运行一次：./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 不一定转发）

程序明明跑起来了，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