systray是go最成熟轻量的跨平台托盘方案，但需严格遵循：systray.run必须在main goroutine阻塞调用；图标字节流须按平台格式（windows用24×24 png、macos推荐icns、linux需strip元数据）；菜单点击须用独立goroutine监听clickedch。
用 systray 做系统托盘图标是目前 Go 桌面应用最成熟、最轻量的跨平台方案，但直接照抄示例大概率在 macOS 或 Linux 上图标不显示、菜单无响应、甚至构建失败——问题几乎都出在资源加载、cgo 配置和平台行为差异上。
systray.Run 必须在 main goroutine 调用，且不能被 defer 或 recover 包裹
systray.Run 启动的是一个阻塞式事件循环，它会接管主线程并持续处理系统消息。一旦你把它放进 goroutine、或用 defer 包裹、或套进 recover() 里，图标就永远不会出现，程序可能静默退出。
- ✅ 正确写法：
func main() { systray.Run(onReady, onExit) } - ❌ 错误写法：
go systray.Run(...)、defer systray.Run(...)、if err := recover(); err != nil { systray.Run(...) } - Windows/macOS 下看似能跑，但 Linux（尤其是 Wayland 环境）会直接卡死或报
Failed to connect to session bus
图标字节流必须是平台原生格式，PNG 不等于“能用”
systray.SetIcon(iconData []byte) 接收的是原始图像字节，但各平台对格式、尺寸、透明通道要求不同：Windows 接受 16×16 或 32×32 的 PNG；macOS 要求 @2x/3x 多倍图且推荐 ICNS；Linux（尤其是 GNOME）偏好 22×22 或 24×24 的纯 PNG，且 alpha 通道必须正确 —— 缺少或错位会导致图标变白块或完全不可见。
- Windows：可用
go:embed icon.png+image/png解码后转为[]byte，尺寸建议 24×24 - macOS：最好提供
.icns文件（用iconutil生成），否则 fallback 到 PNG 容易模糊或缩放失真 - Linux：避免带嵌入式颜色配置文件（如 sRGB profile），用
convert -strip清理 PNG 元数据 - 调试技巧：先用硬编码 24×24 纯红方块测试：
iconData := []byte{...}，排除资源路径/加载逻辑问题
菜单点击必须用 goroutine 监听 ClickedCh，且不能阻塞主循环
systray.AddMenuItem 返回的菜单项自带 ClickedCh channel，但它的读取必须在独立 goroutine 中进行。如果在 onReady 里同步读取，会卡住整个托盘事件循环，后续菜单点击全部失效。
- ✅ 正确模式：
go func() { for - ❌ 错误模式：
if （只读一次，且阻塞） - 多个菜单项共用一个 goroutine 时，要用
select+case分流，别漏掉default或无限for导致 CPU 占用飙升 - 注意：macOS 上菜单项图标仅支持
SetIcon（传入字节流），且仅在菜单展开时加载 —— 若图标数据为空或格式错误，该项会显示为空白，但不会报错
CGO_ENABLED=1 和平台依赖库缺失是构建失败的头号原因
systray 底层调用 Windows API / Cocoa / libappindicator，因此必须启用 cgo。禁用 cgo 或缺少系统开发包，会导致编译通过但运行时报错，例如：
- Linux：
libappindicator3-1-dev（Ubuntu/Debian）或libappindicator-gtk3-devel（Fedora）未安装 → 运行时 panic：undefined symbol: app_indicator_new - macOS：
CGO_ENABLED=0→ 构建成功但图标不出现，终端无提示，只有ps aux | grep yourapp能看到进程在，却无托盘项 - Windows：需确保使用 MSVC 工具链（非 MinGW），否则
shell32.dll调用失败，图标悬停文字不显示 - CI/CD 构建时记得显式设置：
CGO_ENABLED=1 go build -o app ./main.go
真正麻烦的不是“怎么加图标”，而是“为什么加了没反应”——绝大多数问题藏在字节流来源、cgo 环境、以及平台对图标的隐式约束里。动手前先确认 CGO_ENABLED、再验证图标尺寸与通道、最后用最小可运行示例隔离问题，比反复改 menu 逻辑高效得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
