Go程序需适配launchd管理：主函数须监听SIGTERM/SIGINT后优雅退出，禁用log.Fatal和os.Exit；plist中Label需规范、ProgramArguments为数组、设WorkingDirectory和日志路径；KeepAlive配合ThrottleInterval实现崩溃自启。
Go 程序要作为 macOS 后台服务长期运行，必须用 launchd 管理；直接后台执行 ./myapp & 或用 nohup 无法实现崩溃自拉起、合盖存活、日志统一等关键能力。
如何写一个可被 launchd 管理的 Go 二进制
Go 编译出的二进制默认是前台阻塞式进程，launchd 要求它“自己守着不退出”，否则会反复重启。关键点是：
- 不要在 main 中直接
os.Exit()或 panic 后无处理——这会让 launchd 认为异常退出 - 监听
os.Interrupt和syscall.SIGTERM，做清理后自然返回（让 main 函数结束），这是 launchd 期望的优雅退出路径 - 如果程序需长期驻留（如 HTTP server），确保
http.ListenAndServe或类似调用不被意外 return；可用select {}阻塞主 goroutine，但要配合信号监听做 shutdown - 避免使用
log.Fatal——它等价于os.Exit(1)，触发 launchd 的非零退出码重试逻辑（若配置了KeepAlive）
launchd plist 配置要点（LaunchAgent 场景）
Go 程序通常以当前用户身份运行，放 ~/Library/LaunchAgents/ 下。以下配置项不能错：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
-
Label必须唯一且符合反向域名规范，例如com.myorg.myserver；不能含空格或下划线 -
ProgramArguments是数组：第一个元素是可执行文件路径（/Users/xxx/bin/myserver），后续是参数（如有）；不能拼成单字符串 -
RunAtLoad设为true可让登录即启动，但调试阶段建议先设false，手动用launchctl load测试 - 务必设置
WorkingDirectory，否则 Go 程序读取相对路径配置文件（如config.yaml）会失败 - 加
StandardOutPath和StandardErrorPath，否则所有日志进 Unified Logging，查起来费劲
如何让 Go 服务崩溃后自动重启
launchd 不支持 systemd 那样的 Restart=on-failure 细粒度控制，靠 KeepAlive 实现基础自愈：
立即学习“go语言免费学习笔记（深入）”；
-
<key>KeepAlive</key><true/>：只要进程退出（无论退出码），立刻重启——最常用 -
<key>KeepAlive</key><dict><key>Crashed</key><true/></dict>：仅当被信号杀死（SIGSEGV/SIGABRT 等）才重启，忽略正常 exit(0) - 必须配
ThrottleInterval（如60），否则进程秒退秒启会触发系统限流，导致 launchd 暂停拉起 - 若 Go 程序因内存超限被 Jetsam 杀掉，
log show --last 5m | grep -i jetsam可确认；这时KeepAlive仍生效，但需优化程序内存使用
调试 launchd + Go 服务时最常卡在哪
90% 的问题出在环境和权限链路上，不是代码本身：
- Go 二进制权限必须是
-rwxr-xr-x，且所属用户与 launchd agent 一致（launchctl bootstrap gui/$(id -u)加载的是当前用户 session） - 不要用
sudo launchctl加载用户级 agent；对应命令是launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.xxx.plist - 环境变量不会自动继承终端的（比如
$PATH或 Go 相关的$GOROOT），要么在 plist 里用EnvironmentVariables显式声明，要么在 Go 程序里硬编码路径 - 合盖休眠后服务是否存活，取决于
PowerNap设置和程序是否响应SIGUSR1（macOS 休眠前会发此信号）；多数 Go 程序忽略它，所以合盖即暂停——这不是 bug，是设计使然
