fyne不能直接go run是因为其依赖系统原生gui后端且需fyne package嵌入图标、清单及资源；必须先app.new()再newwindow()并调用a.run()，否则窗口不显示或静默退出。
直接用 go run main.go 启动 GUI 程序大概率失败——这不是代码写错了，而是跨平台桌面框架根本没打算让你这么跑。
为什么 fyne 不能 go run？
Fyne 依赖系统原生 GUI 后端（macOS 的 Cocoa、Windows 的 Win32、Linux 的 X11/Wayland），而 go run 不会触发资源嵌入、图标绑定或清单文件生成。它跳过了构建时必需的元数据注入步骤，导致窗口不显示、图标缺失、甚至进程静默退出。
-
fyne package -os linux会自动调用go build，并嵌入图标、生成Info.plist（macOS）或.desktop文件（Linux） - 漏掉
fyne package直接go build，图标和应用标识仍会丢失 - Linux 下若报
GLXBadContext，临时加环境变量：GDK_BACKEND=wayland或LIBGL_ALWAYS_SOFTWARE=1，但后者会显著降低动画性能
wails init 总是卡住或失败？
本质是前端依赖安装环节出问题：wails init 内部执行 npm install，国内网络常因超时或 node-gyp 编译失败中断。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 必须满足：
node -v ≥ 18.17.0、npm -v ≥ 9.6.0；旧版本可能静默失败 - 换镜像：
npm config set registry https://registry.npmmirror.com - 仍卡在
electron-builder或sharp？用wails init -n myapp --skip-frontend-install跳过，进frontend/后手动npm install --no-optional - Windows 用户务必提前运行：
npm install --global windows-build-tools，或改用 WSL2 初始化
//wails:export 方法不生效？
Wails 不识别普通函数，只认结构体方法，且签名、注册、调用三处任一出错都会导致前端调用返回 undefined 或 pending。
- 接收者只能是
func(a App) Do()（值类型）或func(a *App) Do()（指针），不能是*map或接口 - 参数/返回值仅支持：
string、int、bool、导出字段结构体（字段名首字母大写）、[]T、map[string]T；不支持chan、func - 结构体字段必须加
json:标签，例如：Name string `json:"name"` - 注册必须传指针：
wails.Run(&App{})，不是wails.Run(App{})，更不能是wails.Run(new(App))（GC 可能提前回收） - 前端调用必须包裹在
wails.ready(() => { ... })内，否则window.backend还未初始化
WebView 方案为什么看起来最简单却容易翻车？
github.com/zserge/webview 确实支持 go run，但它把复杂性转移到了系统环境上：它依赖宿主系统的 WebView 引擎（Windows 的 EdgeHTML/WebView2、macOS 的 WebKit、Linux 的 WebKitGTK），不同平台行为差异大。
- Linux 必须预装
libwebkit2gtk-4.0-dev（Ubuntu/Debian）或webkit2gtk4.0-devel（RHEL/Fedora） - Windows 上若未启用 WebView2 运行时，
webview.New()会 panic，错误信息可能是failed to create webview，但无明确提示 - macOS Catalina 及以后默认禁用 JIT，某些前端库（如 Vue Devtools）可能无法加载
- 所有 UI 逻辑写在 Go 里，但样式、交互、状态管理全靠 HTML/CSS/JS，Go 层只做桥接——这本质上是个“带 Go 后端的网页”，不是原生控件应用
真正跨平台不是“一次编译到处运行”那么简单；每个框架都在权衡：Fyne 换来原生感但构建链路重，Wails 换来 Web 开发体验但前后端耦合深，WebView 换来轻量但系统依赖隐晦。选哪个，取决于你愿为哪类复杂性买单。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
