fyne是唯一免配环境、纯go跨平台gui方案，需调用a.run()启动事件循环，打包必须用fyne package而非go build，并通过resources.go嵌入资源。
直接用 fyne，别试其他库——当前唯一能跨平台、免配环境、纯 Go 写完就跑的方案。gotk3 要装 GTK 和 C 工具链，webview 是浏览器壳，shiny 已归档，只有 fyne 真正做到 go run main.go 一秒钟弹窗。
为什么 go run main.go 运行后窗口闪退或根本没出现
不是代码写错，是生命周期没走完。Fyne 不是“创建窗口即显示”，它依赖显式启动的事件循环。
-
app.New()必须在main()第一行调用：它初始化全局状态（主题、剪贴板、事件分发器），漏掉会导致a.NewWindow()panic -
w.ShowAndRun()或w.Show() + a.Run()必须执行：前者适合单窗口极简场景；后者必须放在所有 UI 构建之后、函数末尾，a.Run()是阻塞调用，不执行它，main()退出进程就结束了 - 常见错误写法：
func main() { w := app.NewWindow("x"); w.Show() }→ 没调a.Run()，窗口渲染后立即退出 - 别写
app.MainLoop()：该函数不存在，编译失败或运行时 panic
打包成可执行文件后图标丢失、双击无反应、macOS 拒绝打开
go build 出来的二进制只是裸程序，没有图标、清单、资源绑定、平台元信息——这不是 bug，是设计如此。
- 必须用
fyne package，不是go build：它自动调用go build，同时注入Info.plist（macOS）、manifest（Windows）、desktop 文件（Linux），并嵌入图标和资源 - macOS 必须带
-appID：例如fyne package -os darwin -appID com.example.myapp，缺了 Gatekeeper 直接拒绝运行 - Windows 防黑框：
fyne package -os windows自动加-ldflags="-H windowsgui"，手动加会重复报错 - 图标路径和尺寸：根目录放
icon.png，256×256 像素，名字不能是icon_256.png或带空格，否则 Windows 任务栏显示为空
widget.Entry 中文输入卡顿、光标错位、回车不触发提交
这不是你代码的问题，是 Fyne v2.3 之前版本在 macOS/Linux 下与输入法协同的底层缺陷，v2.4+ 已修复大部分情况。
- 先升级：运行
go get fyne.io/fyne/v2@latest，确保用的是 v2.4 或更高版本 - 回车默认换行，不是提交：需手动绑定
entry.OnSubmitted，且必须在w.Show()之后、a.Run()之前调用entry.Focus()才能获得焦点响应回车 - 避免在
OnChanged里做同步耗时操作：比如网络请求或文件读写，会阻塞 UI 线程，加剧卡顿；改用go func(){ ... }()异步处理，再通过app.Instance().Invoke()更新界面 - 别频繁调
entry.SetText()：它重置光标位置，容易导致输入法候选框偏移；高频更新优先用data.BindString()
打包后资源（图片/字体/SVG）加载失败、os.Open 报 “no such file”
Fyne 打包时把资源编译进二进制，不再走文件系统路径——用相对路径读取必然失败。
- 资源必须放在
resources/目录下（项目根目录），然后运行fyne bundle -o resources.go resources/生成 Go 文件 - 在
main.go里import _ "./resources"（注意是空白导入），让资源注册生效 - 加载图标或图片时，用
resources.MyIconPng这类变量，而不是字符串路径；字体、翻译文件（.po）同样要走这套流程 - 别用
os.Open("assets/icon.png")或ioutil.ReadFile：工作目录不可靠，且资源不在磁盘上
真正卡住人的从来不是怎么写一个按钮，而是 OpenGL 初始化失败时没报错、中文输入法候选框飘在屏幕外、或者打包后图标在 Windows 任务栏里变成白方块——这些细节藏在“跨平台”三个字后面，但不会自动消失。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
