Python的curses库用于创建终端文本界面,通过curses.wrapper()初始化并自动恢复终端,使用stdscr进行屏幕操作,支持光标控制、文本输出、键盘输入处理和颜色显示,结合cbreak、noecho、keypad和curs_set等设置可提升交互体验。

Python 的 curses 库用于在终端中创建文本式用户界面(TUI),比如菜单、进度条、实时日志显示等。它能控制光标位置、颜色、键盘输入,适合开发命令行下的交互程序。下面介绍基本用法和常见操作。
1. 基本结构:初始化与清理
使用 curses 时,必须通过 curses.wrapper() 启动主函数,它会自动处理初始化和异常后的终端恢复。
import cursesdef main(stdscr):
清屏
stdscr.clear() # 显示文字 stdscr.addstr(0, 0, "Hello, Curses!") stdscr.addstr(1, 0, "Press any key to exit...") # 刷新显示 stdscr.refresh() # 等待按键 stdscr.getch()使用 wrapper 启动
curses.wrapper(main)
立即学习“Python免费学习笔记(深入)”;
stdscr 是默认的屏幕对象,所有绘制都通过它进行。
2. 控制光标与文本输出
用 addstr(y, x, string) 在指定坐标写入文本。注意:y 在前,x 在后。
常用方法:
- addstr(y, x, "text"):在 (y,x) 写字符串
- move(y, x):移动光标
- clrtoeol():清除当前行光标后内容
- clear():清整个屏幕(慎用,可能闪烁)
- refresh():刷新屏幕,使改动可见
示例:逐行输出并换行:
for i in range(5):
stdscr.addstr(i, 0, f"Line {i}")
stdscr.refresh()
3. 处理键盘输入
curses 支持阻塞和非阻塞输入模式。
- getch():等待用户按键,返回 ASCII 码或特殊键值
- nodelay(True):设为非阻塞模式,无输入时 getch 返回 -1
判断特殊按键:
key = stdscr.getch()
if key == ord('q'):
return
elif key == curses.KEY_UP:
stdscr.addstr("Up Arrow pressed")
elif key == curses.KEY_ENTER or key in [10, 13]:
stdscr.addstr("Enter pressed")
4. 颜色支持
启用颜色需调用 curses.start_color(),然后定义前景/背景对。
# 初始化颜色
if curses.has_colors():
curses.start_color()
curses.init_pair(1, curses.COLOR_RED, curses.COLOR_WHITE)
curses.init_pair(2, curses.COLOR_GREEN, curses.COLOR_BLACK)
使用颜色对
stdscr.addstr(2, 0, "Red on White", curses.color_pair(1))
stdscr.addstr(3, 0, "Green on Black", curses.color_pair(2))
颜色常量:COLOR_RED, COLOR_BLUE, COLOR_YELLOW 等。
5. 其他实用设置
提升用户体验的小技巧:
- curses.cbreak():关闭行缓冲,按键立即响应(不等回车)
- curses.noecho():关闭输入回显(密码输入有用)
- stdscr.keypad(True):启用功能键(如方向键、F键)支持
- curses.curs_set(0):隐藏光标(1 显示,2 极粗)
通常放在 main 函数开头:
curses.cbreak() curses.noecho() stdscr.keypad(True) curses.curs_set(0)
结束前应还原状态(wrapper 会自动处理)。
基本上就这些。掌握这些就能写简单的终端交互程序了。注意测试时别卡住,记得留退出方式(比如按 q)。









