curses开发中如何正确获取光标当前位置？getyx返回值异常咨询

核心规则说明 #

• 标准curses（含Python内置curses模块）不存在stdscr.getxy()方法，原生光标位置获取接口为curses.getyx(win)，返回窗口内部维护的逻辑光标坐标元组(y, x)。使用自定义封装的getxy()时，需优先排查封装逻辑是否错误返回窗口边界值。
• getmaxyx(win)返回值为(窗口高度, 窗口宽度)，并非坐标。curses坐标默认从0开始计数：窗口最大行号为高度减1，最大列号为宽度减1。观测到的返回值Y=27、X=99，恰好对应28行高、100列宽窗口的最大合法坐标，与实际光标位置无关。
• getyx()仅读取curses窗口的逻辑光标位置，与终端物理光标位置无默认关联。只有执行光标移动、内容输出操作，并调用refresh()同步curses输出到终端后，两者位置才会对齐。
• 坐标计算不存在“窗口宽度减当前光标列号”的逻辑：curses的X坐标从窗口最左侧（第1列）为0开始向右递增，光标在第24列时对应的X坐标为23，无需用窗口宽度做反向推导。

常见异常原因 #

• 调用时机错误：窗口初始化后未执行任何光标移动、输出操作，也未调用refresh()，读取到的逻辑光标位置无法与终端实际光标对齐，极端情况下会返回窗口默认边界值。
• 封装逻辑错误：第三方封装的getxy()若错误调用getmaxyx()，会直接返回接近窗口尺寸的数值，而非实际光标位置。
• 需求误判：若需获取终端绝对物理光标位置，curses原生接口不支持直接读取，需通过终端控制序列查询，getyx()仅能返回curses自身维护的窗口内逻辑坐标。

正确操作示例 #

import curses

def main(stdscr):
    # 移动光标到指定位置（第2行对应行号1，第24列对应列号23，坐标从0计数）
    stdscr.move(1, 23)
    # 必须调用refresh同步输出到终端
    stdscr.refresh()
    # 读取光标位置，返回值为(1, 23)
    y, x = curses.getyx(stdscr)
    stdscr.addstr(0, 0, f"当前光标位置：行{y}, 列{x}")
    stdscr.refresh()
    stdscr.getch()

curses.wrapper(main)

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