HPA / HPR / VPR — 绝对与相对定位（CSI ` / CSI a / CSI e）

字节形式

涵盖所有常见的字符串字面量写法，方便正反查找。

说明

三个 ECMA-48 光标定位原语，分别保留另一根轴 —— 形态与 VPA（`\x1b[<row>d`）、CHA（`\x1b[<col>G`，slug `cursor-column`）相同，填补了四元中的另一半。**HPA**（`\x1b[<col>`` ` `）水平位置绝对 —— 移到绝对列 `<col>`（从 1 起），保留当前行。语义等同 CHA（`G`），末字节有别仅因 ECMA-48 § 8.3.57（HPA）与 § 8.3.9（CHA）并列存在。**HPR**（`\x1b[<n>a`）水平位置相对 —— 右移 `n` 列，保留行。效果同 CUF（`\x1b[<n>C`），末字节 `a` 用以区分 ECMA-48 正统形式。**VPR**（`\x1b[<n>e`）垂直位置相对 —— 下移 `n` 行，保留列。同 CUD（`\x1b[<n>B`），仅末字节为 `e`。三者省略时默认 `n=1` / `col=1`；超界数值被钳到可视区域（启用 DECSTBM / DECSLRM 时为对应区域）。实际上现代代码多用 CHA / CUF / CUD / CUB；但每个 ECMA-48 兼容终端都接受 HPA / HPR / VPR 别名，curses 默认能力表里就有它们，因此解析器必须识别这些末字节。HPA 的反引号 ` ` ` 末字节是所有 CSI 末字节中最容易打错的 —— 注意它是 0x60，**不是** 0x27 的单引号（那是 DECIC / DECDC 的中间字节）。

规范出处: ECMA-48 §8.3.57 (HPA) / §8.3.59 (HPR) / §8.3.160 (VPR)

参数

示例

printf '\033[40`status: ok'   # HPA: jump to col 40, keep row (note backtick, not single quote)

import sys; sys.stdout.write('\x1b[5a')   # HPR: move 5 cols right

fmt.Print("\x1b[3e")   // VPR: move 3 rows down

process.stdout.write('\x1b[1`')   // HPA: column 1 (== CR but doesn't move row)

printf("\x1b[10a");   /* HPR: 10 cols right — same effect as \x1b[10C */

终端支持

xterm

支持

Linux console (fbcon)

支持

macOS Terminal.app

支持

iTerm2

支持

Windows Terminal

支持

cmd.exe / ConPTY

部分

kitty

支持

alacritty

支持

WezTerm

支持

Ghostty

支持

GNOME Terminal

支持

Konsole

支持

tmux

不支持

GNU screen

不支持

相关序列

• VPA — 垂直行绝对定位（CSI d）
• CHA — 光标水平绝对位置（列）
• CUU / CUD / CUF / CUB — 移动光标
• CUP — 设置光标位置