Windows 终端转义序列交错：一探究竟，彻底根除

2024-03-18 07:59:34

Windows 终端转义序列交错：深入探究与实用解决方案

作为一位在跨平台交互式终端程序开发方面经验丰富的程序员和技术作家，我曾遭遇过一个令人头疼的问题：在 Windows 终端中，光标查询响应和鼠标事件会交错出现，产生令人困惑的序列。经过深入研究和探索，我总结了导致此问题的根源并分享了解决方案，希望能帮助其他程序员解决类似的难题。

问题交错的转义序列

在 Windows 终端中，光标查询响应和鼠标事件会交错出现。这些序列通常以 \x1b\x1b 开头，但这种模式并不稳定，导致难以解析和处理事件。

问题分析：Windows 终端的交错行为

我发现此交错现象并不仅仅出现在 PowerShell 中，在 cmd.exe 中也会发生。交错序列通常以 \x1b\x1b 开头，但这种模式并不稳定。通过禁用鼠标事件、延迟一段时间、查询光标、再次延迟和重新启用鼠标事件，可以减少交错的发生频率。然而，这种方法会降低程序的响应速度，而且不能完全消除所有交错情况。

解决方案：解析交错序列

既然无法阻止交错，那么解析交错序列就成为了一种可行的方法。根据文档，Windows 终端会使用以下格式发送鼠标事件：

\x1b[<button>;<x>;<y>;<click type>[M]

其中：

<button>：鼠标按钮，例如 32 表示右键
<x> 和 <y>：鼠标指针相对于终端窗口左上角的位置
<click type>：点击类型，例如 M 表示按下

而光标查询响应则使用以下格式：

\x1b[<row>;<column>R

其中：

<row> 和 <column>：光标相对于终端窗口左上角的位置

使用正则表达式，可以从交错序列中提取这些信息并相应地处理鼠标事件或光标查询响应。

代码示例：解析交错序列

以下是使用正则表达式解析交错序列的一个代码示例：

import re

def parse_interleaved_sequence(buf):
    # 匹配鼠标事件
    m = re.match(r'\x1b\[\<(\d*);(\d*);(\d*)([Mm])', buf)
    if m:
        b, x, y, s = (bytes(s) for s in m.groups())
        return "mouse: b=%s, x=%s, y=%s, s=%s" % (b, x, y, s)

    # 匹配光标查询响应
    m = re.match(r'\x1b\[(\d*);(\d*)R', buf)
    if m:
        y, x = (bytes(s) for s in m.groups())
        return "window size: x=%s, y=%s" % (x, y)

    return None