跳到主要内容
ansicode

CUP — 设置光标位置

将光标移动到绝对行/列(从 1 开始)。

字节形式

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

\\x1b[\x1b[row;colH
\\033[\033[1;1H
\\e[\e[1;1H
ESC [ESC [ row ; col H
hex1b 5b ... 48

说明

`H`(CUP)与 `f`(HVP)行为等价。行列从 1 开始计数;同时省略两者时默认为 (1,1),即屏幕或滚动区域的左上角。超出范围的值会被钳制到可视区域内。

规范出处: ECMA-48 §8.3.21 (CUP)

示例

bash
printf '\033[2;5HHello at (2,5)\n'
python
print('\x1b[2;5HHello at (2,5)')
go
fmt.Print("\x1b[2;5HHello at (2,5)\n")
javascript
process.stdout.write('\x1b[2;5HHello at (2,5)\n')
c
printf("\x1b[2;5HHello at (2,5)\n");

终端支持

xterm
支持
Linux console (fbcon)
支持
macOS Terminal.app
支持
iTerm2
支持
Windows Terminal
支持
cmd.exe / ConPTY
支持
kitty
支持
alacritty
支持
WezTerm
支持
Ghostty
支持
GNOME Terminal
支持
Konsole
支持
tmux
不支持
GNU screen
不支持

相关序列

在家族食谱中

CSI 食谱 · 1. 信封 —— `\x1b[` …… `<结尾字节>`