fyne 不适合复杂桌面应用主界面，因采用 opengl 自绘而非原生控件，导致系统集成、高 dpi 控制和原生菜单行为受限；常见启动空白或闪退源于未调用 app.new() 或 w.showandrun()；linux 需安装 opengl 依赖且禁用 ssh x11 转发；中文输入问题需手动指定中文字体；异步操作避免阻塞 ui；打包需显式指定图标与平台适配参数。
Fyne 不适合做复杂桌面应用的主界面框架，尤其当需要深度系统集成、高 DPI 精确控制或原生菜单栏行为时——它用的是 OpenGL 渲染+自绘 UI，不是原生控件封装。
为什么 go run main.go 启动后窗口空白或闪退
最常见原因是没调用 app.New() 创建应用实例，或忘记调用 w.ShowAndRun()（而非仅 w.Show()）。Fyne 的事件循环必须显式启动，否则主 goroutine 退出即进程终止。
-
app.New()必须在main()开头调用，不能延迟或放在 goroutine 里 - 确保
w := widget.NewLabel("hello")之后，用container.NewVBox(w)包一层再传给widget.NewWindow()，直接传 widget 会 panic - Linux 下若报
GLXBadContext，需安装libgl1-mesa-dev和xorg-dev，且不能在 SSH X11 转发环境下运行（OpenGL 不支持）
widget.NewEntry() 输入中文卡顿或光标错位
Fyne 默认使用 FreeType 渲染字体，但未自动加载系统中文字体。中文输入法（如 fcitx5、ibus）的候选框位置计算依赖字体度量，缺字体就会偏移或卡住。
- 手动指定中文字体：在
app.New()后加app.Settings().SetTheme(&theme.CustomTheme{...})，或更简单——设置环境变量export FYNE_FONT="/usr/share/fonts/truetype/wqy/wqy-zenhei.ttc" - 避免在
entry.OnChanged回调里做同步网络请求，这会阻塞 UI 线程；改用go func(){ ... }()异步处理 -
entry.SetText()会触发OnChanged，若逻辑未防重入，可能造成无限递归更新
打包成二进制后图标不显示、菜单栏消失（macOS/Windows）
Fyne 打包工具 fyne package 默认只嵌入资源路径，不自动注入系统级菜单或图标资源。macOS 要求 .app 包结构，Windows 需要 .ico 文件与 manifest 绑定。
- 图标必须是
.png（推荐 256×256），通过fyne package -icon icon.png指定；.ico文件 macOS 不识别 - macOS 上右键 Dock 图标无菜单？需在
app.New()后立即调用app.Menu = fyne.NewMainMenu(...)，且不能晚于window.Show() - Windows 下任务栏图标模糊？添加
fyne package -ldflags="-H windowsgui"防止控制台窗口弹出，同时启用高 DPI 感知（需 Go 1.21+）
真正麻烦的从来不是写几行 widget.NewButton()，而是字体 fallback、输入法协同、多屏缩放适配这些底层链路——Fyne 把它们藏在了「跨平台」承诺后面，但藏不住。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
