Fyne不能直接go run main.go，因其依赖系统原生GUI后端且需完整生命周期初始化与资源绑定；必须用fyne package打包并确保app.New()、window.ShowAndRun()正确调用。
fyne 不是“写完 go run main.go 就能弹窗”的库，它依赖系统原生 GUI 后端（Cocoa/Win32/X11/Wayland），必须走完整生命周期初始化 + 主循环启动，否则窗口空白、闪退或静默失败。
为什么 go run main.go 常常打不开窗口
这不是你代码写错了，而是 go run 跳过了 Fyne 必需的资源绑定和上下文初始化步骤：
-
go run直接编译并执行临时二进制，不触发fyne的构建钩子，导致图标、清单文件、OpenGL 上下文等缺失 - Linux 下常见
GLXBadContext错误，本质是 GL 上下文创建失败，go run无法保证后端环境就绪 - macOS 和 Windows 上可能“看似运行”，实则窗口未注册到系统事件循环，几毫秒后自动销毁
- 正确做法永远是：
fyne package -os linux（或-os windows/-os darwin），它会调用go build并注入平台专用资源
app.New() 和 window.ShowAndRun() 的顺序与作用
这两个调用不是可选装饰，而是 Fyne 生命周期的刚性要求：
-
app.New()必须是main()中第一行：它初始化全局状态（主题、剪贴板、事件分发器、字体缓存） -
window := app.NewWindow(...)必须在app实例之后：窗口对象依赖应用上下文中的渲染器和事件队列 -
window.ShowAndRun()必须是最后一行（或至少阻塞主线程）：它启动主事件循环；写成window.Show(); app.Run()也行，但漏掉任意一个都会退出 - 常见错误：
return提前结束main()、在 goroutine 里调用ShowAndRun()、或误用app.MainLoop()（该函数不存在）
中文输入卡顿、光标错位的真实原因和解法
这不是你的 widget.NewEntry() 配置问题，而是 Fyne v2.3 及更早版本在 macOS/Linux 下与输入法（IM）事件链不兼容：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 根本原因是文本输入事件未被正确路由到 IM 引擎，导致按键延迟、候选框位置偏移、光标重绘异常
- Fyne v2.4+ 已修复大部分 IM 兼容逻辑，升级是最直接解法：
go get fyne.io/fyne/v2@latest - macOS 用户若仍卡顿，优先切换为系统自带“简体拼音”，避免使用鼠须管、小狼毫等第三方输入法
- 别在
Entry.OnChanged回调里做同步 IO（如http.Get或os.ReadFile），这会阻塞 UI 线程，加剧卡顿 - 避免频繁调用
entry.SetText()更新内容——它会重置光标位置；需要响应式更新时，改用data.BindString()
打包后图标丢失、资源找不到、白屏的硬性条件
Fyne 不会自动扫描项目目录加载图片/字体/配置文件，所有外部资源必须显式嵌入：
立即学习“go语言免费学习笔记（深入）”；
- 资源文件（如
icon.png、config.json）必须放在项目根目录下的resources/子目录中 - 必须运行
fyne bundle -o resources.go resources/生成 Go 源码，再import "./resources"到main.go - 图标路径不能写死为
"./icon.png"，而要用resource.IconPng（由bundle生成的变量名） - 配置文件读取不能用
os.Open("config.json")，而应通过app.Storage().URL("config.json")获取沙箱内路径 - Linux 打包后黑屏？检查是否安装了
libgl1（Ubuntu/Debian）或mesa-libGL（RHEL/Fedora）
