Go本身无GUI能力，必须依赖Fyne/Wails等框架，且构建需严格配置GOBIN/GOROOT隔离、GO111MODULE=on、系统后端（如GDK_BACKEND）、图标预处理及前端环境（如npm镜像），否则易白屏或静默崩溃。
直接用 go build 无法生成可运行的跨平台桌面应用——Go 本身不带 GUI 能力，必须依赖 Fyne、Wails 等框架，而它们对构建流程、环境变量、系统后端都有硬性要求。跳过框架专用命令或配错环境，大概率白屏、静默退出、或启动即崩溃。
GOROOT 和 GOBIN 必须显式隔离，尤其在多框架混用时
GOROOT 指向 Go 安装根目录（如 /usr/local/go），GOBIN 则应指向独立路径（如 $GOPATH/bin），否则 fyne package 或 wails build 可能误把二进制写入 $GOROOT/bin，导致后续命令冲突或权限失败。
- Windows 用户：在“用户变量”中设
GOBIN为%GOPATH%\bin，**不要**设为%GOROOT%\bin - macOS/Linux：在
~/.zshrc或~/.bashrc中添加export GOBIN=$GOPATH/bin，并确保$GOBIN在PATH前置 - 验证方式：
go env GOROOT GOBIN输出路径不应重叠；which fyne和which wails应指向$GOBIN下，而非$GOROOT/bin
fyne package 构建前必须确认系统后端和 OpenGL 环境
Fyne 在 Linux 下默认尝试 GLX（X11），若系统是 Wayland 会话或无 GPU 驱动，fyne package 成功但运行时报 GLXBadContext，窗口打不开且无日志。
- 临时修复（仅开发）：
GDK_BACKEND=wayland fyne_app或LIBGL_ALWAYS_SOFTWARE=1 fyne_app - 长期方案：Linux 用户应在构建前设环境变量
export GDK_BACKEND=wayland（Wayland 环境）或export GDK_BACKEND=x11（X11 环境），再执行fyne package - 图标必须预处理：
fyne bundle -package main -prefix resource icon.png，然后在main.go中import _ "./resource"，漏掉这步 macOS 上图标为空，Windows 上任务栏显示默认 Go 图标
wails init 失败多数源于前端链路卡在 npm install
wails init 不只是初始化 Go 项目，它会自动创建 frontend/ 目录并执行 npm install。国内网络下常因 electron-builder、sharp 等原生模块编译超时或 node-gyp 失败而中断。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 先检查版本：
node -v≥18.17.0，npm -v≥9.6.0，旧版本会静默跳过关键步骤 - 换镜像：
npm config set registry https://registry.npmmirror.com - 跳过前端安装：
wails init -n myapp --skip-frontend-install，进frontend/后手动运行npm install --no-optional - Windows 用户务必提前运行：
npm install --global windows-build-tools，否则 node-gyp 编译必然失败
GO111MODULE=on 是硬性前提，且不能依赖 auto
Wails 和 Fyne 的 CLI 工具内部调用 go build 时，若模块模式未强制开启，会回退到 GOPATH 模式，导致依赖解析错误、go.mod 被忽略、甚至找不到本地 replace 路径。
- 全局启用：
go env -w GO111MODULE=on，**不要**设为auto - 验证：
go env GO111MODULE输出必须是on；新建项目后执行go mod init example.com/app，再go mod tidy应能正常拉取fyne.io/fyne/v2或github.com/wails-app/wails/v2 - VS Code 用户注意：编辑器可能缓存旧 env，修改后需重启窗口或执行
Go: Reload Window
真正麻烦的不是哪一步配错了，而是错误被层层掩盖：比如 fyne package 显示成功，但运行时白屏；wails build 没报错，前端却始终调不到 Go 方法——这些问题往往卡在环境变量作用域、shell 配置未生效、或 IDE 缓存了旧的 GOPATH，而不是代码本身。
