前言
在这个软件开发不断趋于多端融合的时代，开发者们渴望找到一种方式，用一套语言、一个逻辑、一次编码，部署到多个平台。Python，作为简洁高效的现代语言，也拥有了这样的愿景和实践路径。而 Toga —— 一个由 BeeWare 项目推动的 GUI 框架，正是这一愿景的重要载体。
本教程将带你从零出发，深入理解 Toga 框架的设计理念与核心组件，结合完整可运行的代码，帮助你快速掌握 Python 跨平台桌面开发的能力。无论你是初涉图形界面的 Python 爱好者，还是期望发布自己应用的独立开发者，这篇文章都将是一份值得收藏的实践指南。
一、Toga 是什么
Toga是 BeeWare 项目组发展的一个环境组件，是一个用 纯 Python 编写的环境与 GUI 框架，支持开发 跨平台的图形界面应用。
一段代码，运行多系统：
-
支持 Windows / macOS / Linux
-
支持 Android / iOS (Beta)
-
支持 Web (Beta)
Toga 所附属的 BeeWare 是一个使 Python 成为“全端语言”的惊艳力量，它有全套工具链：
-
briefcase：打包成应用 -
rubicon：连接原生 API -
crystal-ball：行进路线规划器
二、快速开始：Hello Toga
步骤 1：安装 Toga
pip install toga==0.4.4
步骤 2：最简单示例
import toga
from toga.style import Pack
from toga.style.pack import COLUMN, CENTER
def on_press(widget):
print("按钮被点击了")
def build(app):
btn = toga.Button("点击我", on_press=on_press, style=Pack(padding=10))
box = toga.Box(children=[btn], style=Pack(direction=COLUMN, alignment=CENTER))
return box
def main():
return toga.App("Hello Toga", "org.example.hellotoga", startup=build)
if __name__ == '__main__':
main().main_loop()
三、常用组件 Widget 示例
下面是 Toga 中最常用的一些组件，我们通过简单的代码示例逐一说明它们的用途和效果。
Label：文本标签
toga.Label("你好，世界！", style=Pack(padding=10))
Button：按钮
def on_click(widget):
print("按钮被点击了！")
btn = toga.Button("点我", on_press=on_click, style=Pack(padding=10))
TextInput：文本输入框
name_input = toga.TextInput(placeholder="请输入名字", style=Pack(padding=10))
Switch：开关控件
def on_toggle(widget):
print("当前状态：", widget.is_on)
switch = toga.Switch("开关按钮", on_toggle=on_toggle, style=Pack(padding=10))
Selection：下拉菜单（类似 ComboBox）
def on_select(widget):
print("你选择了：", widget.value)
dropdown = toga.Selection(items=["Python", "JavaScript", "Go"], on_select=on_select)
Slider：滑动条
def on_slide(widget):
print("当前值：", widget.value)
slider = toga.Slider(range=(0, 100), on_change=on_slide)
Table：表格控件
table = toga.Table(
headings=["姓名", "年龄"],
data=[["张三", "20"], ["李四", "22"]],
style=Pack(flex=1)
)
MultilineTextInput：多行文本框
multiline = toga.MultilineTextInput(value="这是多行文本输入框", style=Pack(height=100))
WebView：网页展示控件
webview = toga.WebView(url="https://python.org", style=Pack(flex=1))
Canvas：绘图区域（适合画图或小游戏）
canvas = toga.Canvas(style=Pack(flex=1))
@canvas.on_draw
def draw_handler(canvas, context):
context.move_to(10, 10)
context.line_to(100, 100)
context.stroke()
把多个组件组合成一个 UI
def build(app):
name_input = toga.TextInput(placeholder="输入姓名")
greet_btn = toga.Button("打招呼", on_press=lambda w: print("你好,", name_input.value))
switch = toga.Switch("是否订阅？")
dropdown = toga.Selection(items=["CSDN", "知乎", "掘金"])
box = toga.Box(children=[name_input, greet_btn, switch, dropdown], style=Pack(direction=COLUMN, padding=10))
return box
小技巧：组件组合 = UI 逻辑结构
Toga 没有拖拽式 UI 工具，但通过组件 + 样式组合你可以构建出很强的界面系统。你甚至可以用 JSON 或配置动态生成 UI！
四、布局系统：Box + Pack 解析
Toga 使用 Box 和 Pack 风格系统来布局界面。每个 Box 是一个容器，可以横向或纵向排列其子控件，而 Pack 提供对齐、间距、宽高等布局属性。
示例 1：横向排列两个按钮
import toga
from toga.style import Pack
from toga.style.pack import ROW, CENTER
def build(app):
btn1 = toga.Button("按钮 1", style=Pack(padding=5))
btn2 = toga.Button("按钮 2", style=Pack(padding=5))
box = toga.Box(children=[btn1, btn2], style=Pack(direction=ROW, alignment=CENTER))
return box
def main():
return toga.App("横向布局", "org.example.rowlayout", startup=build)
if __name__ == '__main__':
main().main_loop()
示例 2：嵌套布局
import toga
from toga.style import Pack
from toga.style.pack import ROW, CENTER
from toga.style.pack import COLUMN
def build(app):
label = toga.Label("上方标签", style=Pack(padding=5))
inner_box = toga.Box(
children=[toga.Button("左"), toga.Button("右")],
style=Pack(direction=ROW, padding=5)
)
outer_box = toga.Box(children=[label, inner_box], style=Pack(direction=COLUMN))
return outer_box
def main():
return toga.App("嵌套布局", "org.example.layout", startup=build)
if __name__ == '__main__':
main().main_loop()
示例 3：使用 flex 自动填充空间
import toga
from toga.style import Pack
from toga.style.pack import ROW
def build(app):
left = toga.Label("左", style=Pack(flex=1, padding=10, background_color='lightblue'))
right = toga.Label("右", style=Pack(flex=2, padding=10, background_color='lightgreen'))
box = toga.Box(children=[left, right], style=Pack(direction=ROW))
return box
def main():
return toga.App("Flex布局", "org.example.flexlayout", startup=build)
if __name__ == '__main__':
main().main_loop()
五、综合示例：个人信息表单
下面是一个小型表单应用，综合使用了 Label、TextInput、Selection、MultilineTextInput、Button 等控件。
import toga
from toga.style import Pack
from toga.style.pack import COLUMN, ROW, LEFT
def on_submit(widget):
print("提交表单")
def build(app):
name_input = toga.TextInput(placeholder="请输入姓名", style=Pack(flex=1, padding=5))
gender_select = toga.Selection(items=["男", "女"], style=Pack(flex=1, padding=5))
bio_input = toga.MultilineTextInput(style=Pack(height=80, padding=5))
submit_btn = toga.Button("提交", on_press=on_submit, style=Pack(padding=10))
box = toga.Box(style=Pack(direction=COLUMN, padding=10))
box.add(toga.Label("姓名：", style=Pack(padding=5)))
box.add(name_input)
box.add(toga.Label("性别：", style=Pack(padding=5)))
box.add(gender_select)
box.add(toga.Label("个人简介：", style=Pack(padding=5)))
box.add(bio_input)
box.add(submit_btn)
return box
def main():
return toga.App("表单示例", "org.example.formdemo", startup=build)
if __name__ == '__main__':
main().main_loop()
六、打包为桌面应用：Briefcase
Toga 项目推荐使用 Briefcase 进行打包。
安装 Briefcase
pip install briefcase
创建项目骨架
briefcase new
然后按照提示输入项目名、包名、作者等信息。
构建 + 运行 + 打包
cd your_app_name
briefcase dev # 本地开发运行
briefcase build # 构建项目
briefcase package # 打包成安装包
支持平台
Briefcase 可以将 Toga 应用打包为：
-
Windows 安装程序（MSI）
-
macOS .app 程序
-
Linux AppImage / Flatpak
-
iOS / Android 应用（需要配置 Xcode/Android Studio）
七、总结 & 推荐实践
-
Toga 是纯 Python 的 GUI 库，语法清晰、组件丰富
-
使用 Box + Pack 布局灵活，适合构建原型与中型应用
-
通过 Briefcase 可打包为多平台原生程序
-
推荐配合 virtualenv 管理依赖，控制版本（如 Python 3.10 + Toga 0.4.4）
欢迎把你基于 Toga 的创作发出来，一起交流 Python GUI 开发的新未来！
作者注：本教程适配 Python 3.10 与 Toga 0.4.4，示例均在 Windows/macOS 上测试可运行。如需支持新版 Toga，请关注 BeeWare 官方文档 最新更新。
扫一扫
2667
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
