Fyne on Liangweidong's blog

Go-Fyne 入门：Go 跨平台 GUI 实战

Sat, 15 Oct 2016 00:00:00 +0800

什么是 Fyne

Fyne（发音 “feign”）是 2018 年起的 Go 跨平台 GUI 框架，目标：用 Go 写原生体验的桌面应用。

特点：

跨平台：Windows / macOS / Linux（也支持 FreeBSD、嵌入式）
单二进制：编译后无外部依赖
原生控件：用系统原生 GUI 库（Win32 GDI、Cocoa、GTK）
Material Design 风格：类 Flutter 的现代化外观
声明式 API：v2 起更接近 React / Flutter

安装

1
2
3
4
5
6
7
8


# Go 1.20+
go version

# 安装 fyne CLI
go install fyne.io/fyne/v2/cmd/fyne@latest

# 验证
fyne version

系统依赖

Linux (Debian / Ubuntu)

1
2
3
4
5
6
7
8
9


sudo apt install -y \
 libgl1-mesa-dev \
 xorg-dev \
 pkg-config \
 libxrandr-dev \
 libxinerama-dev \
 libxcursor-dev \
 libxi-dev \
 libxxf86vm-dev

macOS

Xcode Command Line Tools：

1

xcode-select --install

Windows

MinGW-w64 + GCC。Scoop 一键装：

1

scoop install gcc

第一个程序

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


package main

import (
 "fyne.io/fyne/v2/app"
 "fyne.io/fyne/v2/widget"
)

func main() {
 a := app.New()
 w := a.NewWindow("Hello Fyne")
 w.SetContent(widget.NewLabel("Hello, 世界!"))
 w.ShowAndRun()
}

1

go run main.go

布局

Fyne 提供 6 种布局：

布局	用途
`container.NewVBox`	垂直排列
`container.NewHBox`	水平排列
`container.NewBorder`	四边 + 中心
`container.NewGrid`	等宽网格
`container.NewGridWrap`	自适应网格
`container.NewCenter`	居中
`container.NewPadded`	加内边距
`container.NewMax`	重叠

1
2
3
4
5
6
7
8
9


vbox := container.NewVBox(
 widget.NewLabel("顶部"),
 widget.NewButton("按钮", func() {
 fmt.Println("点击")
 }),
 widget.NewEntry(),
 widget.NewLabel("底部"),
)
w.SetContent(vbox)

常用控件

基础控件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


// 文本
widget.NewLabel("静态文本")
widget.NewEntry() // 单行输入
widget.NewMultiLineEntry() // 多行输入
widget.NewPasswordEntry() // 密码
widget.NewRichText() // 富文本

// 按钮
widget.NewButton("普通按钮", callback)
widget.NewButtonWithIcon("图标按钮", theme.DocumentIcon(), callback)
widget.NewHyperlink("链接", url)

// 选择
widget.NewCheck("复选框", onChange)
widget.NewRadio([]string{"男", "女"}, onChange)
widget.NewSelect([]string{"Java", "Go", "Rust"}, onChange)
widget.NewSlider(0, 100) // 滑块
widget.NewProgressBar() // 进度条

// 容器
widget.NewCard("标题", "副标题", content)
widget.NewAccordion() // 手风琴
widget.NewTabContainer() // 标签页
widget.NewSplit() // 分割

表单

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


form := &widget.Form{
 Items: []*widget.FormItem{
 {Text: "用户名", Widget: widget.NewEntry()},
 {Text: "密码", Widget: widget.NewPasswordEntry()},
 },
 OnSubmit: func() {
 fmt.Println("提交")
 },
 OnCancel: func() {
 fmt.Println("取消")
 },
}

列表

1
2
3
4
5
6
7


list := widget.NewList(
 func() int { return len(items) },
 func() fyne.CanvasObject { return widget.NewLabel("") },
 func(i int, o fyne.CanvasObject) {
 o.(*widget.Label).SetText(items[i])
 },
)

表格

1
2
3
4
5
6
7
8
9


table := widget.NewTable(
 func() (int, int) { return len(rows), 2 },
 func() fyne.CanvasObject {
 return widget.NewLabel("wide content")
 },
 func(i int, j int, o fyne.CanvasObject) {
 o.(*widget.Label).SetText(fmt.Sprintf("%d-%d", i, j))
 },
)

Canvas 绘图

Fyne Canvas 2D API 适合自定义图形：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


import (
 "fyne.io/fyne/v2/canvas"
 "image/color"
)

// 矩形
rect := canvas.NewRectangle(color.RGBA{255, 0, 0, 255})
rect.Resize(fyne.NewSize(100, 100))

// 圆形
circle := canvas.NewCircle(color.RGBA{0, 255, 0, 255})

// 文本
text := canvas.NewText("Canvas Text", color.Black)
text.TextSize = 24

// 线条
line := canvas.NewLine(color.Black)
line.StrokeWidth = 2

// 图片
img := canvas.NewImageFromResource(resource.ExamplePng())
img.FillMode = canvas.ImageFillOriginal

// 组合
canvasContainer := container.NewWithoutLayout(rect, circle, text, line)

菜单

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


menu := fyne.NewMainMenu(
 fyne.NewMenu("文件",
 fyne.NewMenuItem("新建", func() { /* ... */ }),
 fyne.NewMenuItem("打开", func() { /* ... */ }),
 fyne.NewMenuItemSeparator(),
 fyne.NewMenuItem("退出", func() { a.Quit() }),
 ),
 fyne.NewMenu("帮助",
 fyne.NewMenuItem("关于", func() { /* ... */ }),
 ),
)
w.SetMainMenu(menu)

主题

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


import "fyne.io/fyne/v2/theme"

// 亮色 / 暗色
a.Settings().SetTheme(theme.LightTheme())
a.Settings().SetTheme(theme.DarkTheme())

// 自定义
type MyTheme struct{}
func (m MyTheme) Color(name fyne.ThemeColorName, variant fyne.ThemeVariant) color.Color {
 return color.RGBA{0, 100, 200, 255}
}
a.Settings().SetTheme(MyTheme{})

数据绑定

Fyne v2.1+ 支持响应式数据绑定：

1
2
3
4
5
6
7
8
9


str := binding.NewString()
str.Set("Hello")

entry := widget.NewEntryWithData(str)

// 监听变化
str.AddListener(binding.NewDataListener(func() {
 fmt.Println("值变了:", str.Get())
}))

绑定类型：

binding.NewString() / NewInt() / NewFloat() / NewBool()
binding.NewList() / NewMap()

跨平台编译

1
2
3
4
5
6
7
8


# 在 macOS 上编译 Linux 版本
GOOS=linux GOARCH=amd64 go build -o myapp-linux main.go

# 编译 Windows
GOOS=windows GOARCH=amd64 go build -o myapp.exe main.go

# 编译 macOS（arm64 M1）
GOOS=darwin GOARCH=arm64 go build -o myapp-mac main.go

打包分发

Fyne 自带 fyne CLI 打包：

1
2
3
4
5
6
7


# 打包当前平台
fyne package -name MyApp -icon icon.png

# 跨平台打包（需要对应工具链）
fyne package -os darwin -name MyApp
fyne package -os linux -name MyApp
fyne package -os windows -name MyApp

打包结果：

Linux：MyApp.tar.xz（含 .desktop 文件）
macOS：MyApp.app
Windows：MyApp.exe（可加 installer）

实战：计算器

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32


package main

import (
 "fmt"
 "fyne.io/fyne/v2/app"
 "fyne.io/fyne/v2/container"
 "fyne.io/fyne/v2/widget"
)

func main() {
 a := app.New()
 w := a.NewWindow("计算器")
 w.Resize(fyne.NewSize(300, 400))

 output := widget.NewLabel("0")
 output.TextStyle = fyne.TextStyle{Bold: true}
 output.Alignment = fyne.TextAlignTrailing

 btn := func(label string, fn func()) *widget.Button {
 return widget.NewButton(label, fn)
 }

 digits := container.NewGridWithColumns(3,
 btn("7", func() { output.SetText(output.Text + "7") }),
 btn("8", func() { output.SetText(output.Text + "8") }),
 btn("9", func() { output.SetText(output.Text + "9") }),
 // ...
 )

 w.SetContent(container.NewVBox(output, digits))
 w.ShowAndRun()
}

实战：Todo List

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44


type Todo struct {
 Title string
 Done bool
}

var todos []Todo

func main() {
 a := app.New()
 w := a.NewWindow("Todo")
 w.Resize(fyne.NewSize(400, 600))

 input := widget.NewEntry()
 input.SetPlaceHolder("输入新任务")

 list := widget.NewList(
 func() int { return len(todos) },
 func() fyne.CanvasObject {
 return container.NewHBox(
 widget.NewCheck("", nil),
 widget.NewLabel(""),
 )
 },
 func(i int, o fyne.CanvasObject) {
 c := o.(*fyne.Container)
 c.Objects[0].(*widget.Check).SetChecked(todos[i].Done)
 c.Objects[1].(*widget.Label).SetText(todos[i].Title)
 },
 )

 addBtn := widget.NewButton("添加", func() {
 if input.Text != "" {
 todos = append(todos, Todo{Title: input.Text})
 input.SetText("")
 list.Refresh()
 }
 })

 w.SetContent(container.NewVBox(
 container.NewBorder(nil, nil, nil, addBtn, input),
 list,
 ))
 w.ShowAndRun()
}

下一步

跨平台桌面技术栈对比，看 2014-08-15《桌面开发技术栈对比》
Tauri 2.x 实战，看 2020-05-15《Tauri 2.x 跨平台桌面应用》
Electron 入门，看 2018-12-15《Electron 跨平台桌面应用》

参考资料

Fyne 官方：https://fyne.io/
Fyne Tour：https://tour.fyne.io/
Fyne GitHub：https://github.com/fyne-io/fyne
Fyne 示例：https://github.com/fyne-io/fyne/tree/master/v2/cmd/fyne_demo

桌面开发技术栈对比：Electron vs Tauri vs Qt vs Fyne

Fri, 15 Aug 2014 00:00:00 +0800

跨平台桌面应用 4 大技术栈

技术	底层	语言	包大小	性能	生态
Electron	Chromium + Node.js	JS/TS	80~150MB	★★★	★★★★★
Tauri	系统 WebView + Rust	TS + Rust	2~10MB	★★★★★	★★★
Qt	Qt 库	C++ / QML / Python	30~80MB	★★★★★	★★★★
Fyne	系统 GUI	Go	10~30MB	★★★★	★★

一、Electron

原理

Chromium：渲染 UI（每个窗口一个）
Node.js：调用本地 API（文件系统、进程、IPC）
主进程 + 渲染进程：主进程（Node.js）管理窗口，渲染进程（Chromium）展示 UI

优势

Web 生态完整：React、Vue 任意用
跨平台：Windows / macOS / Linux 一套代码
第三方 SDK 丰富：自动更新、native dialog、native menu

劣势

包大：80MB 起步
内存高：每个窗口一个 Chromium
性能：JS 引擎有 GC 抖动

代表应用

VSCode、Slack、Discord、Notion、Postman、Figma Desktop

适用场景

内部工具 / 中后台
重 UI 重数据展示
团队 JS 技术栈

二、Tauri

原理

系统 WebView：Windows 用 WebView2，macOS 用 WKWebView，Linux 用 WebKitGTK
Rust 后端：编译成原生二进制，提供 IPC、文件系统、shell 等
前端任意：React / Vue / Svelte / Solid / 纯 HTML

优势

极小包：2~10MB（vs Electron 80MB）
低内存：复用系统 WebView
Rust 后端：性能强、安全（内存安全）
细粒度权限：声明式 ACL

劣势

WebView 跨平台表现不一致（Windows 较新，Linux GTK 旧）
生态比 Electron 小
学习曲线：Rust + 前端

代表应用

各种 Rust 生态工具
部分 VSCode 插件、Cursor 编辑器
OpenCode、cc-connect、tinyhumans/openhuman

适用场景

追求包大小 / 启动速度
Rust 团队
命令行 + GUI 一体

三、Qt

原理

Qt 库：跨平台 C++ GUI 库
QWidget：传统 UI
QML：声明式 UI（类 QML + JavaScript）
PyQt / PySide：Python 绑定

优势

性能极强：原生绘制
跨平台：Windows / macOS / Linux / Android / iOS / 嵌入式
工业级：KDE、Autodesk Maya、VirtualBox、VLC
工具链成熟：Qt Creator IDE

劣势

学习曲线陡：C++ + Qt 框架
商业授权：LGPL / GPL / Commercial 三种
包大：30MB+
UI 不够现代（vs Web）

适用场景

工业控制 / 嵌入式 UI
科学计算 / 数据可视化
跨平台 + 高性能

四、Fyne

原理

Go 语言：编译成单一二进制
系统原生控件：Windows GDI、macOS Cocoa、Linux GTK
声明式 API：类 Flutter 风格

优势

跨平台编译：Go 一份代码，Windows/macOS/Linux 任意编译
单二进制：无外部依赖
小包：10~30MB
简单易学

劣势

生态小：第三方库少
UI 不够丰富：控件有限
性能中等：没有 GPU 加速

适用场景

Go 团队
内部工具
简单桌面应用

详细对比

包大小

应用	Electron	Tauri	Qt	Fyne
Hello World	80MB	3MB	30MB	12MB
复杂应用（VSCode 级别）	200MB+	15MB	100MB	40MB

启动时间

应用	Electron	Tauri	Qt	Fyne
冷启动	1.5~3s	0.3~1s	0.2~0.5s	0.5~1s
热启动	0.5~1s	0.1~0.3s	0.1~0.2s	0.2~0.5s

内存占用

应用	Electron	Tauri	Qt	Fyne
空闲	100~200MB	30~80MB	20~50MB	30~70MB
复杂场景	500MB+	150MB	100MB	150MB

选型决策树

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


你的团队用什么语言？
├── JS/TS → Electron（生态最好）
├── Rust → Tauri（性能 + 体积最优）
├── C++ → Qt（性能 + 工业级）
├── Go → Fyne（最简单）
└── Python → PyQt / PySide

你的核心需求是？
├── 包小 + 快 → Tauri
├── 生态丰富 → Electron
├── 高性能 3D / 工业 → Qt
└── Go 写小工具 → Fyne

安装包大小优化

Electron

移除不必要的依赖
用 electron-builder 拆分 platform / arch
用 asar 压缩资源

Tauri

用 release 模式（默认）
启用 LTO（Link Time Optimization）
拆分 release（不同 OS 单独打包）

Qt

静态链接 vs 动态链接
删除用不到的 Qt 模块

Fyne

UPX 压缩
Go 1.20+ 链接器优化

跨平台坑

macOS

签名 + 公证（notarization）必需
沙箱（sandbox）
Apple Silicon（arm64）vs Intel（x64）

Linux

各种发行版：deb / rpm / AppImage / Flatpak
WebView 版本：Ubuntu LTS 用 snap，WebView 是 Chromium

Windows

32 / 64 位
WebView2 Runtime（Win10 1803+ 预装，旧版需引导安装）

下一步

Electron 入门，看 2018-12-15《Electron 跨平台桌面应用》
Tauri 2.x 实战，看 2020-05-15《Tauri 2.x 跨平台桌面应用》
Fyne 入门，看 2016-10-15《Go-Fyne 入门》

参考资料

Electron 官方：https://www.electronjs.org/
Tauri 官方：https://tauri.app/
Qt 官方：https://www.qt.io/
Fyne 官方：https://fyne.io/
Wails（Go + WebView）：https://wails.io/
Flutter Desktop：https://flutter.dev/desktop