Curses中Pad动画：移动Pad时如何高效清除屏幕残留

问题背景 #

在curses中移动Pad时，直接调用pad.refresh()更新新位置会导致旧位置内容残留，且不想每次移动都重绘Pad内容，也不想通过创建额外erasePad来完整擦除旧区域。

测试代码如下：

import curses
import time

def main(stdscr):
  pad = curses.newpad(10, 10)
  ch = ord('A')
  pad.addch(4, 4, ch)
  for y in range(0, 10):
    for x in range(0, 10):
      try:
        pad.insch(y, x, ch)
      except:
        pass
      if x % 9 == 0:
        ch += 1
  pad.refresh(0, 0, 0, 0, 10, 10)
  time.sleep(2)
  pad.refresh(0, 0, 1, 1, 11, 11)
  time.sleep(2)
  pad.refresh(0, 0, 2, 2, 12, 12)
  time.sleep(2)

curses.wrapper(main)

运行后旧位置内容会残留，比如前两行及每行前两个字符无法自动清除。

现有方案的不足 #

通过创建同尺寸erasePad擦除旧区域，虽然能解决问题，但需要维护额外Pad对象，且每次都要完整擦除整个Pad大小的区域，效率较低。

高效优化方案 #

1. 直接利用主窗口擦除旧位置 #

不需要额外创建erasePad，只需记录Pad上一次的显示位置，移动前用主窗口的字符清除操作覆盖旧区域：

import curses
import time

def main(stdscr):
    pad = curses.newpad(10, 10)
    ch = ord('A')
    # 初始化Pad内容
    for y in range(0, 10):
        for x in range(0, 10):
            try:
                pad.insch(y, x, ch)
            except:
                pass
            if x % 9 == 0:
                ch += 1
    
    # 记录Pad的初始位置
    prev_top, prev_left = 0, 0
    pad_height, pad_width = 10, 10
    # 第一次绘制Pad
    pad.refresh(0, 0, prev_top, prev_left, prev_top + pad_height, prev_left + pad_width)
    time.sleep(2)
    
    # 移动到新位置(1,1)
    new_top, new_left = 1, 1
    # 擦除旧位置的所有行
    for y in range(prev_top, prev_top + pad_height):
        stdscr.move(y, prev_left)
        stdscr.clrtoeol()  # 清除当前行从光标位置到行尾的内容
    stdscr.refresh()  # 刷新主窗口的擦除部分
    
    # 绘制Pad到新位置
    pad.refresh(0, 0, new_top, new_left, new_top + pad_height, new_left + pad_width)
    prev_top, prev_left = new_top, new_left
    time.sleep(2)
    
    # 移动到新位置(2,2)
    new_top, new_left = 2, 2
    # 擦除旧位置
    for y in range(prev_top, prev_top + pad_height):
        stdscr.move(y, prev_left)
        stdscr.clrtoeol()
    stdscr.refresh()
    
    pad.refresh(0, 0, new_top, new_left, new_top + pad_height, new_left + pad_width)
    time.sleep(2)

curses.wrapper(main)

2. 只擦除残留的差异区域 #

当Pad向固定方向移动时（比如右下），残留内容仅为旧位置超出新位置的部分，只需擦除这些差异区域即可，进一步提升效率：

import curses
import time

def main(stdscr):
    pad = curses.newpad(10, 10)
    ch = ord('A')
    # 初始化Pad内容
    for y in range(0, 10):
        for x in range(0, 10):
            try:
                pad.insch(y, x, ch)
            except:
                pass
            if x % 9 == 0:
                ch += 1
    
    prev_top, prev_left = 0, 0
    pad_height, pad_width = 10, 10
    pad.refresh(0, 0, prev_top, prev_left, prev_top + pad_height, prev_left + pad_width)
    time.sleep(2)
    
    # 移动到(1,1)：残留区域是旧位置的第0行，以及第1-9行的第0列
    new_top, new_left = 1, 1
    # 擦除第0行全部内容
    stdscr.move(0, 0)
    stdscr.clrtoeol()
    # 擦除第1-9行的第0列字符
    for y in range(1, pad_height):
        stdscr.move(y, 0)
        stdscr.delch()
    stdscr.refresh()
    
    pad.refresh(0, 0, new_top, new_left, new_top + pad_height, new_left + pad_width)
    prev_top, prev_left = new_top, new_left
    time.sleep(2)
    
    # 移动到(2,2)：残留区域是旧位置的第1行，以及第2-9行的第1列
    new_top, new_left = 2, 2
    stdscr.move(1, 1)
    stdscr.clrtoeol()
    for y in range(2, pad_height + prev_top):
        stdscr.move(y, 1)
        stdscr.delch()
    stdscr.refresh()
    
    pad.refresh(0, 0, new_top, new_left, new_top + pad_height, new_left + pad_width)
    time.sleep(2)

curses.wrapper(main)

3. 使用curses.panel模块管理Pad（可选） #

如果场景更复杂，可使用curses.panel模块，它能自动处理窗口/Pad的堆叠与背景刷新，移动Pad时无需手动擦除旧位置：

import curses
import curses.panel
import time

def main(stdscr):
    # 创建Pad并转为Panel
    pad = curses.newpad(10, 10)
    panel = curses.panel.new_panel(pad)
    ch = ord('A')
    # 初始化Pad内容
    for y in range(0, 10):
        for x in range(0, 10):
            try:
                pad.insch(y, x, ch)
            except:
                pass
            if x % 9 == 0:
                ch += 1
    
    # 第一次显示Pad在(0,0)
    panel.move(0, 0)
    curses.panel.update_panels()
    stdscr.refresh()
    time.sleep(2)
    
    # 移动到(1,1)
    panel.move(1, 1)
    curses.panel.update_panels()
    stdscr.refresh()
    time.sleep(2)
    
    # 移动到(2,2)
    panel.move(2, 2)
    curses.panel.update_panels()
    stdscr.refresh()
    time.sleep(2)

curses.wrapper(main)

方案对比 #

• 方案1：通用且简单，无需额外依赖，适合大多数场景
• 方案2：针对固定移动方向优化，擦除区域更小，效率更高
• 方案3：适合复杂的多窗口/Pad管理场景，自动处理背景刷新

内容的提问来源于stack exchange，提问作者DraftyHat