fyne不能直接go run main.go启动，因其依赖系统原生gui后端（cocoa/win32/x11/wayland），而go run跳过资源绑定、图标嵌入、opengl/metal上下文初始化及事件循环注册，导致黑屏、闪退或静默失败。
fyne 不能直接靠 go run main.go 启动跨平台桌面应用——它依赖系统原生图形后端（Cocoa/Win32/X11/Wayland），而 go run 跳过资源绑定、图标嵌入和 OpenGL 上下文初始化，大概率黑屏、闪退或静默失败。
为什么 go run main.go 在 Fyne 里大概率失败
Fyne 不是纯 Go 渲染库，它通过 CGo 调用系统图形 API，并在启动时初始化 OpenGL 或 Metal 上下文。这些操作必须在完整构建流程中完成：go run 仅编译并执行主函数，不触发 Fyne 的资源加载、窗口上下文创建和事件循环注册。
- macOS 上常见
invalid pixel format错误，本质是 Metal fallback 失败 - Linux 下报
GLXBadContext，说明 X11 OpenGL 上下文未正确创建 - Windows 上双击 .exe 闪退，往往因图标未嵌入或 manifest 缺失，但
go run根本不处理这些 - 即使窗口勉强弹出，中文输入法（IBus/Fcitx5）也常失效，因 D-Bus 会话未就绪，而
go run启动的进程不参与桌面环境会话管理
fyne package 是唯一可靠的跨平台构建入口
必须用 fyne package 替代 go build 或 go run，它会自动做三件事：调用 go build、嵌入图标与资源、生成平台特定清单（Info.plist / Windows manifest / desktop entry）。
- macOS：
fyne package -os darwin -appID com.example.myapp，生成 .app 包，含正确签名和 Info.plist - Windows：
fyne package -os windows -icon app.ico -ldflags "-H windowsgui"，防止控制台窗口抢焦点 - Linux：
fyne package -os linux -icon app.png，生成带 desktop 文件的 tar.gz，默认支持 Wayland/X11 双后端 - 图标必须满足尺寸要求：.ico（Windows）需含 16×16、32×32、48×48、256×256；.png（Linux/macOS）推荐 512×512
开发阶段调试：绕过打包，但必须模拟运行时环境
开发时想快速验证逻辑，可临时用 go run，但得手动补全缺失环节：
- macOS 黑屏？加
os.Setenv("FYNE_RENDERER", "software")到main()开头，强制软件渲染（别用于发布） - Linux 报 GLX 错？启动前设
GDK_BACKEND=wayland或LIBGL_ALWAYS_SOFTWARE=1，确认是否显卡驱动问题 - 中文输入卡顿？升级到
fyne.io/fyne/v2@v2.4+，v2.3 及之前在 IBus/Fcitx5 下有事件队列错位 bug - 始终检查
go env GO111MODULE输出是否为on；若为auto或空，go get可能仍走 GOPATH，导致依赖找不到
main 函数结构错误是静默崩溃的最常见原因
Fyne 生命周期强依赖对象创建顺序，漏掉任意一环都会导致窗口不显示或程序秒退：
- 必须先
a := app.New()，再w := a.NewWindow(...)；反序会 panic - 必须调用
w.ShowAndRun()或w.Show()+a.Run()；只w.Show()不启动事件循环，窗口一闪即逝 - 不能在
main()末尾提前return或发生 panic，否则主 goroutine 结束，a.Run()无法持续 - 避免用
app.MainLoop()—— 这是旧版 API，v2 已移除，编译会失败
-icon 路径必须是相对路径且文件真实存在，fyne package 不校验图标有效性，出错只在运行时体现。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
