当前位置：首页 > news >正文

5分钟快速上手Urwid：打造你的第一个终端界面

news 2026/5/26 22:21:52

5分钟快速上手Urwid：打造你的第一个终端界面

【免费下载链接】urwidConsole user interface library for Python (official repo)项目地址: https://gitcode.com/gh_mirrors/ur/urwid

Urwid是一个强大的Python控制台用户界面库，专门用于在Linux、macOS、Cygwin等类Unix系统以及部分Windows系统上构建精美的终端应用程序。无论你是想为命令行工具添加交互界面，还是创建复杂的终端管理工具，Urwid都能提供完整的解决方案。

🚀 为什么选择Urwid？

Urwid不仅仅是一个简单的文本界面库，它提供了完整的GUI框架功能：

自动响应式布局：应用窗口调整时能快速平滑地重新布局
丰富的预置组件：文本框、按钮、复选框、单选按钮、进度条等
灵活的布局系统：支持列、堆叠、框架、网格等多种布局方式
强大的事件循环：支持Twisted、Glib、Tornado、asyncio、trio、ZeroMQ等多种事件循环
丰富的颜色支持：支持24位真彩色、256色和88色模式
UTF-8和CJK编码支持：完美支持中文等复杂字符集

Urwid基础组件分类图

📦 安装Urwid

安装Urwid非常简单，只需要一行命令：

pip install urwid

对于需要额外功能的用户，可以安装扩展包：

pip install urwid[serial,zmq] # 支持ZeroMQ事件循环和LCD显示

🎯 你的第一个Urwid程序

让我们从一个最简单的"Hello World"程序开始。创建hello.py文件：

import urwid # 创建文本组件 txt = urwid.Text("Hello World") # 使用填充器将文本居中 fill = urwid.Filler(txt, "top") # 创建主循环并运行 loop = urwid.MainLoop(fill) loop.run()

运行这个程序，你将在终端中看到居中的"Hello World"文本。按Ctrl+C退出程序。

🔧 添加交互功能

让我们创建一个简单的问答程序，展示Urwid的事件处理能力：

import urwid def exit_on_q(key): if key in {"q", "Q"}: raise urwid.ExitMainLoop() class QuestionBox(urwid.Filler): def keypress(self, size, key): if key != "enter": return super().keypress(size, key) self.original_widget = urwid.Text( f"Nice to meet you,\n{edit.edit_text}.\n\nPress Q to exit.", ) return None edit = urwid.Edit("What is your name?\n") fill = QuestionBox(edit) loop = urwid.MainLoop(fill, unhandled_input=exit_on_q) loop.run()

这个程序会显示一个输入框，输入名字后按回车，程序会显示问候语。

Urwid嵌套小部件布局系统

🎨 使用颜色和样式

Urwid支持丰富的颜色和样式设置。下面是一个颜色测试示例：

import urwid palette = [ ("header", "white", "dark blue"), ("body", "light gray", "black"), ("footer", "white", "dark red"), ] header = urwid.Text(("header", " Urwid Demo "), align="center") body = urwid.Text(("body", "This is the main content area")) footer = urwid.Text(("footer", " Press Q to exit "), align="center") pile = urwid.Pile([header, body, footer]) fill = urwid.Filler(pile, "middle") def exit_on_q(key): if key in {"q", "Q"}: raise urwid.ExitMainLoop() loop = urwid.MainLoop(fill, palette, unhandled_input=exit_on_q) loop.run()

Urwid颜色调色板示例

📊 创建复杂界面

Urwid的真正强大之处在于创建复杂的用户界面。下面是一个简单的任务管理器示例框架：

import urwid # 任务列表 tasks = ["学习Urwid", "编写Python程序", "测试终端界面"] # 创建任务列表项 task_items = [] for task in tasks: task_items.append(urwid.Text(f"• {task}")) # 创建按钮 add_button = urwid.Button("添加任务") quit_button = urwid.Button("退出") # 按钮回调函数 def on_add_button(button): tasks.append("新任务") # 更新界面逻辑... def on_quit_button(button): raise urwid.ExitMainLoop() urwid.connect_signal(add_button, "click", on_add_button) urwid.connect_signal(quit_button, "click", on_quit_button) # 布局 task_list = urwid.ListBox(urwid.SimpleListWalker(task_items)) button_pile = urwid.Pile([add_button, quit_button]) columns = urwid.Columns([("weight", 3, task_list), ("weight", 1, button_pile)]) loop = urwid.MainLoop(columns) loop.run()