Fyne 是 Go 生态中唯一支持真正运行时主题切换的跨平台 GUI 框架，其通过实现 fyne.Theme 接口并调用 app.Settings().SetTheme() 动态生效，要求主题全局单例、完整实现所有方法、手动触发 Refresh() 以确保样式一致。
fyne 是当前 Go 生态中唯一能稳定支持运行时主题切换的跨平台 GUI 框架。其他方案（如 ui、go-gtk、webview）要么不提供主题 API，要么需重启进程，要么依赖外部 CSS/HTML 控制——都不是真正的“桌面级主题切换”。
fyne.Theme 是唯一可动态替换的官方机制
Fyne 的主题系统基于接口 fyne.Theme，它定义了颜色、字体、图标尺寸等全部视觉变量。关键点在于：只要新主题对象实现该接口，就能在运行时调用 app.Settings().SetTheme() 立即生效。
常见错误是试图手动修改 widget 字段（比如 label.TextColor），这不仅无效，还会被下一次重绘覆盖。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 主题必须是全局单例，不能每次切换都
new一个新实例（否则内存泄漏） - 切换前确保所有窗口已调用
w.Show()，否则新主题不会应用到未显示的窗口 - 不要复用
widget.NewLabel后再塞进不同主题窗口——Fyne 内部会缓存样式，需重新创建 widget 或调用w.Refresh()
示例片段：
func switchToDark(a fyne.App) {
a.Settings().SetTheme(fyne.DarkTheme())
}
func switchToLight(a fyne.App) {
a.Settings().SetTheme(fyne.LightTheme())
}自定义主题必须完整实现 fyne.Theme 接口
Fyne 不接受“只改几个颜色”的半吊子主题。哪怕你只想换主色，也得返回全部 Color、Font、Icon 实现——否则运行时 panic。
容易踩的坑：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 忘记实现
Icon(theme.IconName) fyne.Resource方法，导致按钮图标消失 - 返回
nil字体（如TextSize对应的Font），触发空指针崩溃 - 在
Color方法里硬编码 RGB 值却不适配暗色模式逻辑（比如把背景设成color.RGBA{0,0,0,255}，但亮色主题下应该白）
正确做法是封装一个结构体，统一管理明/暗两套值：
type MyTheme struct {
dark bool
}
func (t MyTheme) Color(name fyne.ThemeColorName, variant fyne.ThemeVariant) color.Color {
if t.dark {
switch name {
case theme.ColorNameBackground: return color.NRGBA{30, 30, 30, 255}
case theme.ColorNamePrimary: return color.NRGBA{121, 196, 118, 255}
}
} else {
switch name {
case theme.ColorNameBackground: return color.NRGBA{255, 255, 255, 255}
case theme.ColorNamePrimary: return color.NRGBA{79, 162, 74, 255}
}
}
return theme.DefaultTheme().Color(name, variant)
}切换后布局错乱？检查 widget.Refresh() 调用时机
Fyne 不会自动重绘所有 widget。当你切换主题后，部分组件（尤其是自定义 Widget 或含 CanvasObject 的）可能仍显示旧样式，因为它们没收到刷新通知。
根本原因：Fyne 的刷新是“按需触发”，不是“全量重绘”。
解决方式：
- 对于标准 widget（
widget.Label、widget.Button），只要它们在窗口树中且已显示，SetTheme()后会自动刷新 - 对于自定义 widget，必须在
Refresh()方法里显式读取当前主题（theme.CurrentTheme()），并据此更新内部状态 - 如果用了
widget.NewForm或container.NewAdaptiveGrid，切换后需手动调用其父容器的Refresh()
别写这种代码：
// ❌ 错误：假设 Refresh() 会递归触发所有子项 myForm.Refresh()
应写成：
// ✅ 正确：确保父容器重绘，触发子项样式更新 myWindow.Content().Refresh()
主题切换真正难的不是换颜色，而是状态一致性：配置是否持久化、托盘图标是否同步变色、系统级暗色模式变更时能否自动响应、多显示器不同缩放比下字体是否错位——这些细节不处理，用户一眼就能看出是“假暗色模式”。
