上一篇
Python curses模块教程：终端字符界面开发指南 | Python编程
Python curses模块教程
掌握终端字符界面开发的核心技术
什么是curses模块？
Python的curses模块是一个用于创建基于文本的用户界面（TUI）的标准库，它提供了一套控制字符终端屏幕显示的API。curses库最初是为Unix系统开发的，现在已移植到多个平台，包括Windows。
使用curses模块，开发者可以：
- 创建全屏终端应用程序
- 精确控制光标位置
- 处理键盘输入事件
- 添加颜色和文本属性
- 开发复杂的字符界面应用
典型应用场景：系统监控工具、文本编辑器(如vim)、终端游戏、配置工具等。
安装与兼容性
在大多数Unix/Linux系统上，curses模块是Python标准库的一部分。对于Windows用户，需要安装额外的包：
Windows安装命令
pip install windows-curses
注意： curses在Windows上的功能可能不如Unix系统完整，建议在Linux/macOS上进行开发。
基本概念与术语
| 术语 | 描述 |
|---|---|
| 窗口(Window) | curses中的基本绘图区域，可以创建多个窗口 |
| 屏幕(Screen) | 代表整个终端显示区域的主窗口 |
| 坐标系统 | 原点(0,0)在屏幕左上角，y轴向下延伸，x轴向右延伸 |
| 光标(Cursor) | 指示下一个字符绘制位置 |
| 属性(Attributes) | 文本的显示特性：加粗、闪烁、反色等 |
基本工作流程
curses应用程序的基本结构
import curses
def main(stdscr):
# 1. 初始化设置
curses.curs_set(0) # 隐藏光标
stdscr.keypad(True) # 启用特殊按键
# 2. 设置颜色对
curses.start_color()
curses.init_pair(1, curses.COLOR_RED, curses.COLOR_BLACK)
# 3. 主循环
while True:
# 清屏
stdscr.clear()
# 绘制界面
height, width = stdscr.getmaxyx()
stdscr.addstr(0, 0, "Python curses教程", curses.A_BOLD)
stdscr.addstr(2, 2, "按ESC键退出", curses.color_pair(1))
# 获取用户输入
key = stdscr.getch()
if key == 27: # ESC键
break
# 刷新屏幕
stdscr.refresh()
# 启动curses应用
curses.wrapper(main)核心功能详解
1. 文本输出
使用addstr()方法在指定位置输出文本：
文本输出示例
# 在(行, 列)位置输出文本
stdscr.addstr(5, 10, "Hello, curses!")
# 添加文本属性
stdscr.addstr(6, 10, "加粗文本", curses.A_BOLD)
stdscr.addstr(7, 10, "闪烁文本", curses.A_BLINK)
stdscr.addstr(8, 10, "反色文本", curses.A_REVERSE)2. 颜色处理
curses支持16种基本颜色，通过颜色对组合前景和背景色：
颜色设置示例
# 初始化颜色系统
curses.start_color()
# 定义颜色对 (ID, 前景色, 背景色)
curses.init_pair(1, curses.COLOR_RED, curses.COLOR_BLACK)
curses.init_pair(2, curses.COLOR_GREEN, curses.COLOR_WHITE)
curses.init_pair(3, curses.COLOR_BLUE, curses.COLOR_YELLOW)
# 使用颜色对
stdscr.addstr(10, 5, "红色文本", curses.color_pair(1))
stdscr.addstr(11, 5, "绿底白字", curses.color_pair(2) | curses.A_BOLD)3. 键盘输入处理
使用getch()方法获取键盘输入：
键盘事件处理
# 获取单个字符
key = stdscr.getch()
# 特殊按键常量
if key == curses.KEY_UP:
stdscr.addstr(1, 1, "上箭头")
elif key == curses.KEY_DOWN:
stdscr.addstr(1, 1, "下箭头")
elif key == curses.KEY_ENTER or key == 10:
stdscr.addstr(1, 1, "回车键")
elif key == 27: # ESC键
return4. 创建子窗口
curses支持创建多个窗口，实现复杂界面布局：
子窗口创建示例
# 创建子窗口 (行数, 列数, 起始行, 起始列)
win = curses.newwin(10, 40, 5, 5)
# 在子窗口中操作
win.border() # 添加边框
win.addstr(2, 2, "这是一个子窗口")
win.refresh()完整示例：简易文本编辑器
简易文本编辑器
import curses
def text_editor(stdscr):
# 初始化设置
curses.curs_set(1) # 显示光标
stdscr.keypad(True)
curses.start_color()
curses.init_pair(1, curses.COLOR_CYAN, curses.COLOR_BLACK)
# 编辑器状态
text = []
cursor_y, cursor_x = 0, 0
stdscr.addstr(0, 0, "简易文本编辑器 - 按Ctrl+S保存，Ctrl+Q退出", curses.A_REVERSE)
while True:
# 显示文本内容
stdscr.move(1, 0)
for i, line in enumerate(text):
if i < curses.LINES - 2:
stdscr.addstr(i+1, 0, line)
# 移动光标
stdscr.move(cursor_y+1, cursor_x)
# 获取输入
key = stdscr.getch()
# 处理按键
if key == curses.KEY_UP and cursor_y > 0:
cursor_y -= 1
elif key == curses.KEY_DOWN and cursor_y < len(text) - 1:
cursor_y += 1
elif key == curses.KEY_LEFT and cursor_x > 0:
cursor_x -= 1
elif key == curses.KEY_RIGHT:
cursor_x += 1
elif key == curses.KEY_ENTER or key == 10:
text.insert(cursor_y+1, "")
cursor_y += 1
cursor_x = 0
elif key == 263 or key == 127: # 退格键
if cursor_x > 0:
line = text[cursor_y]
text[cursor_y] = line[:cursor_x-1] + line[cursor_x:]
cursor_x -= 1
elif key == 19: # Ctrl+S 保存
with open("output.txt", "w") as f:
f.write("\n".join(text))
stdscr.addstr(curses.LINES-1, 0, "文件已保存!".ljust(curses.COLS), curses.color_pair(1))
elif key == 17: # Ctrl+Q 退出
break
elif 32 <= key <= 126: # 可打印字符
line = text[cursor_y] if cursor_y < len(text) else ""
if cursor_x < curses.COLS - 1:
text[cursor_y] = line[:cursor_x] + chr(key) + line[cursor_x:]
cursor_x += 1
# 确保光标在合理范围内
cursor_x = min(cursor_x, len(text[cursor_y]) if cursor_y < len(text) else 0)
# 清空状态行
stdscr.addstr(curses.LINES-1, 0, " " * curses.COLS)
curses.wrapper(text_editor)简易文本编辑器 - 按Ctrl+S保存，Ctrl+Q退出
Hello, this is a simple text editor
created with Python curses module.
Press Ctrl+S to save your work.
Press Ctrl+Q to exit.
光标位置: (3, 10)
最佳实践与注意事项
- 始终使用
curses.wrapper()，它简化了初始化和异常处理 - 避免在终端大小改变时崩溃 - 处理
curses.KEY_RESIZE事件 - 注意坐标边界检查，防止
addstr()越界导致崩溃 - 对于复杂应用，考虑使用第三方库如
urwid或prompt_toolkit - 使用
curses.cbreak()和curses.noecho()获得更好的输入控制
重要： 在开发过程中，如果程序异常退出，终端可能会保持异常状态。输入
reset命令可以恢复终端正常显示。
总结
Python curses模块为开发终端字符界面提供了强大的工具集。通过本教程，您已经学会了：
- curses模块的基本概念和工作原理
- 如何初始化和清理curses环境
- 文本输出和样式控制方法
- 键盘事件处理和用户交互
- 创建窗口和子窗口
- 开发一个简易文本编辑器
虽然现代GUI应用更常见，但curses在服务器管理、远程连接和轻量级工具开发中仍有重要价值。掌握curses开发能力，将让您能够创建出高效、专业的终端应用程序。
本文由ShaoYiTai于2025-07-31发表在吾爱品聚，如有疑问，请联系我们。
本文链接：https://521pj.cn/20256935.html
发表评论