推荐 fyne：纯 go 实现、跨平台一键构建；gotk3 依赖 gtk 需配 c 工具链，webview 非原生，shiny 已归档。项目须按 fyne 约定组织，用 fyne build 而非 go build。
用 fyne 还是 gotk3？选错库直接卡在编译第一步
Go 原生不支持 GUI，所有桌面应用都得靠第三方绑定。目前真正能跨平台、有持续维护、且 Go 风格自然的只有 fyne；gotk3 依赖系统级 GTK 库，Windows/macOS 上要手动配 C 工具链，CI 构建常失败。webview 类方案（比如 webview-go）看似轻量，但实际是把浏览器当壳，无法调系统 API（如托盘、通知、文件对话框），也不算“原生桌面应用”。
实操建议：
-
fyne是当前唯一推荐起点：它用纯 Go 实现渲染层，go run main.go就能跑，macOS/Windows/Linux 一键构建 - 别碰
golang.org/x/exp/shiny：已归档，无维护，示例代码全报错 - 如果必须调 Windows API（比如注册全局快捷键），再考虑
golang.org/x/sys/windows+fyne混合，而不是换库
fyne.Build 报错 “no buildable Go source files” 怎么办
这是新手最常卡住的地方：不是代码写错了，而是没按 fyne 的构建约定组织项目。
常见错误现象：
- 直接
go build—— 错，fyne要求用fyne build - main.go 不在 module 根目录，或
go.mod里没声明module名 ——fyne会找不到入口 - 用了
_ "fyne.io/fyne/v2/theme"这类空白导入但没实际调用主题函数 —— 某些版本会静默跳过资源绑定
正确做法：
- 确保
go.mod存在且第一行是module example.com/myapp - 运行
fyne build -os windows（不是go build），它会自动注入资源、处理图标、打包成可执行文件 - 图标必须是
icon.png放在项目根目录，且尺寸为 256×256 —— 少一个像素或名字带下划线都会导致 Windows 上任务栏图标为空
窗口关闭后程序不退出？检查 app.Quit() 和 goroutine 泄漏
fyne 默认不会在主窗口关闭时退出进程，这是有意设计（支持多窗口、托盘常驻），但多数单窗口工具需要“关窗即退出”。
使用场景：
- 工具类小应用（如 JSON 格式化器、本地 Markdown 预览器）—— 关窗就要
os.Exit(0) - 后台服务型应用（如网盘同步客户端）—— 关窗只隐藏，靠托盘菜单控制生命周期
实操关键点：
- 在
window.SetOnClosed(func() { a.Quit() })里调a.Quit()（a是app.New()返回的实例），不是os.Exit - 如果用了
time.Tick、http.ListenAndServe或自启 goroutine，必须在OnClosed里显式停掉，否则进程僵死 -
fyne的Quit()不会等 goroutine 结束，所以清理逻辑得自己加sync.WaitGroup或context.CancelFunc
Mac 上签名失败 / Windows 上杀毒软件报毒？绕不开的二进制元数据
Go 编译出的二进制默认没有数字签名、没有资源描述（如公司名、版本号），macOS Gatekeeper 和 Windows SmartScreen 就会拦。
性能与兼容性影响：
- macOS 上不签名 → 双击提示“已损坏”，必须右键“打开”才能运行
- Windows 上无版本信息 → 杀软可能标记为“未知发行者”，尤其带网络请求的 app
- 签名本身不改变功能，但
fyne build不处理签名，得额外用codesign或signtool
能做的最小补救：
- macOS：用
codesign --force --deep --sign - ./myapp（仅开发测试，正式发布需 Apple Developer ID） - Windows：加
version.json文件（含ProductName、FileVersion），再用fyne build -ldflags "-H windowsgui"隐藏控制台窗口 - 别用 UPX 压缩 —— 会破坏签名，且部分杀软将 UPX 视为可疑特征
真正的难点不在代码，在发布环节：签名证书、时间戳服务器、Apple 开发者账号审核、微软 SmartScreen 学习期……这些和 Go 本身无关，但缺一不可。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
