必须用 fyne package 打包而非 go build，因需自动嵌入平台元信息（如 macos 的 info.plist、windows 的 manifest）、绑定资源路径，并正确处理生命周期；手动构建会导致双击无反应、黑屏或弹控制台。
直接上手写 app.New() 和 w.ShowAndRun() 能跑起来，但跨平台发布时大概率在 macOS 双击无反应、Linux 点开黑屏、Windows 弹控制台——根本原因不是代码逻辑错，而是漏了生命周期绑定和平台元信息嵌入。
必须用 fyne package 打包，别碰 go build
Fyne 的图标、Info.plist（macOS）、manifest（Windows）、资源路径绑定全靠 fyne package 完成。它内部自动调用 go build，你手动先 go build 再试图“补打包”，只会让二进制结构错乱。
-
fyne package -os windows自动加-ldflags="-Hwindowsgui"，避免黑框弹出 -
fyne package -os darwin -appID com.example.app必须带-appID，否则 Gatekeeper 拒绝运行 -
fyne package -os linux会生成.desktop文件和图标目录，缺了就看不到托盘图标、资源加载失败 - macOS 上用
upx压缩会破坏代码签名，双击直接拒载；Linux 静态链接下可压，但需CGO_ENABLED=0 go build，否则动态库路径错乱
app.Run() 是硬性终点，不是可选项
窗口闪一下就退出？终端卡住没报错？八成是 a.Run() 没调，或调早了、调错了。
-
app.New()必须是main()第一行：它初始化事件循环、主题、剪贴板等全局状态，漏掉会导致a.NewWindow()panic -
a.Run()必须放在最后：它阻塞并驱动整个 GUI 生命周期；写成app.MainLoop()会编译失败（该函数不存在） -
w.ShowAndRun()是快捷写法，仅适用于单窗口极简场景；多窗口、需控制启动时机、或要监听生命周期事件时，必须拆开写w.Show()+a.Run() - 前面有
os.Exit()、未捕获的panic、或 goroutine 提前结束，都会导致a.Run()根本没执行到
Linux 下没反应？先查 OpenGL 和桌面会话
不是代码问题，是环境缺失。常见现象：双击无反应、终端静默退出、或报 GLXBadContext / libGL error: unable to load driver。
- 目标机器必须装
libgl1（Debian/Ubuntu）或mesa-libGL（RHEL/Fedora），且不能在 SSH 终端或容器里直接运行 GUI 二进制 - Wayland 会话下可能黑屏，临时调试可加
FYNE_X11=1强制走 X11 后端 - 远程连接后想测试？用
GDK_BACKEND=wayland ./myapp或LIBGL_ALWAYS_SOFTWARE=1 ./myapp，但这是退化方案，动画卡顿、性能差，别用于发布 - 确认是否在真实桌面会话中运行：
echo $XDG_CURRENT_DESKTOP应有输出，空值说明是 headless 环境
拖放、后台任务、UI 更新，线程安全是隐形门槛
Fyne 要求所有 widget 操作必须在主线程，但没人会告诉你哪些地方悄悄越界了。
- 文件拖放用
SetOnDropped回调，参数是换行分隔的绝对路径字符串，需strings.Split(s, "\n")解析；macOS 还得手动补Info.plist的LSItemContentTypes并签名带 entitlements - 后台耗时操作（如读大文件、网络请求）必须起新 goroutine，但更新 UI 时不能直接调
label.SetText()，得用app.Instance().Sync()投递回主线程 - 别在
OnDropped或 goroutine 里调runtime.LockOSThread()：Fyne 已保证回调在线程安全上下文中执行，锁了反而卡死 UI - widget 不能当普通结构体传参或缓存为全局变量，必须由 Fyne 的组件树管理，否则渲染异常或事件丢失
最易被忽略的是：所有平台差异不在 Go 代码里，而在构建命令、环境变量、系统依赖和签名配置中。写完 main.go 只完成 30%，剩下 70% 是 fyne package 的参数、目标机的 GL 库、macOS 的 entitlements 文件、以及确保 a.Run() 真的被执行到了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
