如何使用ANSI序列在Python终端检测鼠标悬停位置？

Textual实现鼠标悬停交互核心靠ANSI序列和事件解析，步骤如下：

• 开启终端鼠标跟踪：它会根据终端类型（通过TERM环境变量识别）发送对应ANSI序列，比如最常用的\x1b[?1000h，让终端开始上报鼠标移动、点击等事件。
• 捕获并解析鼠标事件：终端会把鼠标动作转换成特定格式的ANSI序列发回程序，Textual的事件循环实时捕获这些序列，解析出鼠标的精确坐标（行和列）。
• 匹配组件区域：Textual维护所有UI组件的布局信息，每个按钮都有自身的位置和尺寸范围。拿到鼠标坐标后，会检查该坐标是否落在某个按钮的区域内。
• 触发样式更新：如果坐标匹配按钮区域，就标记按钮为“悬停”状态，调用渲染逻辑发送ANSI颜色序列（比如\x1b[48;5;XXm修改背景色）重新绘制按钮，实现变色效果。

你用的序列混了大量和鼠标跟踪无关的命令，自然没效果，按以下方法调整：

• 精简有效序列：删掉冗余的\x1b[?1h、\x1b[?9h、\x1b[?38h、\x1b[?47h，只保留鼠标跟踪相关的：
  • 基础鼠标移动/点击跟踪：\x1b[?1000h
  • 需滚轮支持：追加\x1b[?1003h
  • 需窗口绝对坐标：追加\x1b[?1002h
• 切换到终端原始模式：默认终端会缓冲输入，不会实时传递鼠标事件。Python里得用termios和tty模块切换到原始模式，否则发了序列也收不到事件。
• 测试代码参考：
  运行下面的代码，移动鼠标就能看到终端返回的事件序列，说明鼠标跟踪生效：

  import sys
  import termios
  import tty
  
  old_settings = termios.tcgetattr(sys.stdin)
  try:
      tty.setraw(sys.stdin.fileno())
      # 启用鼠标跟踪
      print('\x1b[?1000h', end='', flush=True)
      print("移动鼠标，按Ctrl+C退出")
      while True:
          char = sys.stdin.read(1)
          if char == '\x1b':
              rest = sys.stdin.read(5)
              print(f"捕获鼠标事件: {repr(char + rest)}")
  finally:
      # 关闭鼠标跟踪并恢复终端设置
      print('\x1b[?1000l', end='', flush=True)
      termios.tcsetattr(sys.stdin, termios.TCSADRAIN, old_settings)
  

• 检查终端兼容性：确保使用现代终端（Windows Terminal、iTerm2、Konsole等），部分老旧终端或默认配置不支持鼠标跟踪，需在终端设置里开启相关选项（比如xterm要开启allowMouseEvents）。

内容的提问来源于stack exchange，提问作者ateng-chen