必须用 fyne package 打包而非 go build，因其自动嵌入平台元信息（如 macos 的 info.plist、windows 的 manifest）、绑定资源路径并处理生命周期；手动构建会导致双击无反应、黑屏或弹控制台。
必须用 fyne package 打包，别碰 go build
直接 go build 出来的二进制，在 macOS 上双击无反应、Linux 点开黑屏、Windows 弹黑框——这不是代码 bug，而是缺失平台元信息。Fyne 的图标、Info.plist（macOS）、manifest（Windows）、资源路径绑定全靠 fyne package 自动注入。
fyne package 内部已调用 go build，你手动先 go build 再“补打包”，只会让二进制结构错乱，窗口初始化失败或资源加载为空。
-
fyne package -os windows自动加-ldflags="-Hwindowsgui"，避免控制台窗口抢焦点 -
fyne package -os darwin -appID com.yourorg.opsconsole必须带-appID，否则 Gatekeeper 拒绝运行 -
fyne package -os linux会生成.desktop文件和图标目录，缺了托盘图标不显示、配置文件读取失败
a.Run() 是硬性终点，不是可选项
窗口闪一下就退出？终端卡住没报错？八成是 a.Run() 没调，或调早了、调错了。它不是“可有可无的启动函数”，而是驱动整个 GUI 生命周期的事件泵。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
app.New()必须是main()第一行：初始化事件循环、主题、剪贴板等全局状态，漏掉会导致a.NewWindow()panic -
a.Run()必须放在最后：它阻塞并接管控制权；写成app.MainLoop()会编译失败（该函数不存在） -
w.ShowAndRun()是快捷写法，仅适用于单窗口极简场景；运维控制台通常需多窗口、状态监听、热重载配置，必须拆开写w.Show()+a.Run()
Linux 下没反应？先查 OpenGL 和桌面会话
不是代码问题，是环境缺失。常见现象：双击无反应、终端静默退出、或报 GLXBadContext/libGL error: unable to load driver。
- 目标机器必须装
libgl1（Debian/Ubuntu）或mesa-libGL（RHEL/Fedora） - 不能在 SSH 终端或容器里直接运行 GUI 二进制；确认是否在真实桌面会话中：
echo $XDG_CURRENT_DESKTOP应有输出，空值说明是 headless 环境 - Wayland 会话下可能黑屏，临时调试可加
FYNE_X11=1强制走 X11 后端 - VirtualBox / Parallels 用户大概率遇到 Metal fallback 失败，直接设
os.Setenv("FYNE_RENDERER", "software")开启软件渲染（仅调试用，动画卡顿）
Windows 图标不显示、双击闪退？检查图标格式与路径
Fyne 对 Windows 资源嵌入很敏感，图标路径、manifest、Go 构建标志三者必须对齐。
- 图标必须是
.ico格式，且包含多个尺寸（至少16×16、32×32、48×48、256×256），用在线工具如icoconvert.com批量生成 - 图标文件必须放在项目根目录（不是
resources/子目录），命令中路径写相对路径：fyne package -icon app.ico - 仍闪退？补上
-ldflags "-H windowsgui"：fyne package -icon app.ico -ldflags "-H windowsgui" - 打包前务必先
go run main.go确认能跑通，避免把编译错误打包进.exe
运维控制台往往要读取本地日志、执行 shell 命令、监听进程状态，这些操作都依赖底层环境一致性。Fyne 本身不处理这些逻辑，但一旦打包或渲染链路断掉，所有业务功能都会失效——最容易被忽略的不是按钮怎么写，而是 fyne package 是否真执行成功、a.Run() 是否真走到最后一行、目标机器是否有 OpenGL 驱动可用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
