核心问题是本地环境变量未对齐和部署流程缺乏错误兜底：goos/goarch必须显式指定以避免exec format error；cgo_enabled=0需强制静态编译防容器panic；exec.command须捕获stderr、设超时及绝对路径；systemd需配置workingdirectory、restartsec和日志输出；go mod vendor不能完全离线，仍需处理cgo和系统依赖。
Go 环境搭不好，go run 都报错；部署脚本写不对，docker build 卡在中间就退出。核心问题就两个：本地环境变量没对齐、部署流程没做错误兜底。
GOOS 和 GOARCH 交叉编译必须显式指定
很多人以为在 macOS 上 go build 出来就能直接扔到 Linux 服务器跑，结果一执行就报 exec format error。这是因为 Go 默认按当前系统编译，不会自动适配目标平台。
- Linux 服务器（x86_64）：运行
GOOS=linux GOARCH=amd64 go build -o myapp . - ARM64 服务器（如树莓派或 AWS Graviton）：用
GOOS=linux GOARCH=arm64 go build -o myapp . - Windows 服务端部署？加
CGO_ENABLED=0避免动态链接库依赖：CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o myapp.exe .
漏掉 CGO_ENABLED=0 时，go build 仍会成功，但二进制在无 libc 的容器里直接 panic —— 这个坑不报错，只静默失败。
部署脚本里 exec.Command 必须检查 stderr 并设超时
用 exec.Command("docker", "build", ...) 启动命令很常见，但默认不捕获错误输出，Run() 只返回 exit code != 0，根本不知道哪一行 Dockerfile 出错了。
- 用
cmd.Stderr = &bytes.Buffer{}捕获日志，出错时打印完整上下文 - 加
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Minute)，避免docker build卡住导致整个发布流程挂起 - 别信
os/exec的默认行为：它不自动继承父进程的PATH，如果服务器上docker在/usr/local/bin/docker而非/usr/bin/docker，命令直接报exec: "docker": executable file not found in $PATH
实际线上脚本里，建议先 which docker 检查路径，再把绝对路径传给 exec.Command。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
systemd 服务配置容易忽略 WorkingDirectory 和 RestartSec
systemctl start myapp 显示 active (running)，但日志里全是 open config.yaml: no such file or directory —— 这是因为没设 WorkingDirectory，程序默认从 / 启动，读不到相对路径的配置文件。
-
WorkingDirectory必须填绝对路径，比如/var/www/myapp，不能写./myapp -
RestartSec=5很关键：没设的话，进程崩溃后 systemd 立即重试，可能触发 10 次失败后进入failed状态并停服 - 别漏
StandardOutput=journal和StandardError=journal，否则journalctl -u myapp查不到任何输出
最常被跳过的细节是权限：如果 User=nobody，但 WorkingDirectory 下的 logs/ 目录属主是 root，服务启动直接 Permission denied —— 这类错误不会出现在 journal 日志第一行，得翻最后几条。
go mod vendor 不解决所有依赖问题
有人觉得 go mod vendor 后把 vendor/ 打包上传，就能彻底离线构建。但现实是：某些包（比如 cgo 依赖的 net 或 os/user）仍会尝试访问网络解析 DNS 或读取系统用户数据库。
- 真正离线构建，得加
-ldflags "-extldflags '-static'"强制静态链接（仅限 Linux） - 验证是否真离线：在断网机器上跑
go build -mod=vendor -v .，看有没有go get类报错 -
vendor/目录本身不包含replace指向的本地路径模块，那些还得手动 cp 进去
vendor 不是银弹。它能锁住远程模块版本，但挡不住底层 C 库或系统调用的运行时依赖 —— 这点在 Alpine 容器里尤其明显，musl 和 glibc 的兼容性问题不会在 go build 阶段暴露，只在 docker run 时炸。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
