Fyne 从 v2.4 起完全适配 Go Modules，不再依赖 GOPATH；若执行 go get github.com/fyne-io/fyne/v2 报 cannot find package，通常是未关闭 GOPATH 模式或 Go 版本过低。
确认 Go 版本和 GOPATH 是否还在干扰 Fyne
Fyne 从 v2.4 开始已完全适配 Go Modules，默认不依赖 GOPATH。如果你还在用 go get github.com/fyne-io/fyne/v2 并遇到 cannot find package，大概率是没关掉 GOPATH 模式或用了太老的 Go（
- 运行
go version确保 ≥ 1.16；低于这个版本请升级，别硬扛 - 检查是否意外启用了
GOPATH模式：执行go env GO111MODULE，输出必须是on；如果不是，加环境变量GO111MODULE=on - 不要手动
cd $GOPATH/src/...再go build—— Fyne 项目必须在模块根目录下运行命令
macOS 上启动应用黑屏或报错 “invalid pixel format”
这是 macOS Metal 渲染后端在某些旧显卡或虚拟机里 fallback 失败的典型表现，不是代码写错了。
- 临时绕过：运行时加环境变量
export FYNE_RENDERER=software，再go run main.go - 长期方案：在
main()开头插入os.Setenv("FYNE_RENDERER", "software")，比 shell 环境变量更可靠 - 注意：开启
software渲染后，动画会变卡，仅用于调试；真机发布前务必测试默认 Metal 后端 - VirtualBox / Parallels 用户基本逃不开这个坑，别纠结驱动，直接切软件渲染
Windows 下打包成 .exe 后图标不显示、双击闪退
Fyne 自带的 fyne package 工具对 Windows 资源嵌入很敏感，图标路径、manifest、Go 构建标志三者必须对齐。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 图标必须是
.ico格式，且包含多个尺寸（至少 16×16、32×32、48×48、256×256），用在线工具如 icoconvert.com 批量生成 - 确保图标文件放在项目根目录（不是
resources/子目录），且命令中路径写相对路径：fyne package -icon app.ico - 如果仍闪退，加
-ldflags "-H windowsgui"防止控制台窗口抢焦点：fyne package -icon app.ico -ldflags "-H windowsgui"
- 打包前先
go run main.go确认能跑通，避免把编译错误打包进 exe
Linux 上无法输入中文或快捷键失效
多数源于系统缺少 IBus 或 Fcitx5 的 D-Bus 服务未就绪，Fyne 默认依赖桌面环境的输入法框架。
- Ubuntu/Debian：装
ibus并重启会话：sudo apt install ibus ibus-clutter，然后注销重登 - Fedora/RHEL：启用
ibus-daemon，检查ps aux | grep ibus是否存活 - 快捷键（如 Ctrl+C）失效？确认没在终端里用
Ctrl+Shift+V粘贴触发了终端捕获——Fyne 应用要单独点击窗口获得焦点 - Wayland 用户注意：Fyne 当前（v2.4）对 Wayland 支持有限，建议临时切 X11（登录界面选 “GNOME on Xorg”）
Fyne 的跨平台性很实在，但每个平台的“实”法不一样：macOS 卡在渲染后端，Windows 卡在资源嵌入，Linux 卡在输入法集成。别指望一次配置全平台畅通，得按系统一个个过。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
