VPA — 垂直行绝对定位（CSI d）

在哪里用到

实际会发出该序列的工具——把抽象字节锚定到你已经用过的命令上。

• vim / neovim status line redraw—`:redrawstatus` 与每窗口的 `&statusline` 重绘路径用 VPA 跳到状态行，同时保留光标当前列 —— 省去 CUP `\x1b[<row>;<col>H` 来回切换和缓冲区光标处于行中时的额外列运算
• htop / btop / glances column-aligned rows—在写入页眉 / 页脚最左列后，htop 发 VPA 跳到下一行同一列，而不必为每行重算列 —— 列恒定正是 htop 纵向条柱在 SIGWINCH 重绘下仍干净渲染的关键
• ncurses `wmove(WIN, row, col)` when column unchanged—ncurses 的差分渲染器在脏行追踪指示列与上次光标列一致时发 VPA `\x1b[<row>d` 而非 CUP —— 每次重绘省 1-2 字节，在慢速远程 PTY 上累计显著
• less status-line repaint—less 通过 VPA 跳到底行 + EL `\x1b[K`（清行）+ 写入来重绘 `:` 提示符 —— 上次换行后列已为 0，因此用 VPA 即可，不必 CUP
• tmux pane-status-format updates—tmux 每窗格状态行更新（`set -g pane-status-format`）发 VPA 落到窗格视口内的状态行 —— `\x1b[<row>d` 在窗格做水平分割且列原点不同时仍能干净通过每窗格转换

相关误区

该序列在实践中常见的踩坑——每条链接到完整的症状、成因与修复。

• ⚠\x1b[0d（VPA，Pn=0）不会停在第 0 行 —— VPA 与 CUP 一样从 1 起，第 1 行是 \x1b[1d·#cup-1-based-not-0-based
• ⚠\x1b[d（省略 Pn）默认为 1 而非 0 —— \x1b[d 等同 \x1b[1d，跳到第 1 行·#csi-default-params

常见问题

针对这条序列，开发者真正会去搜索的问题的简短回答。

\x1b[<n>d（VPA）与 \x1b[<n>;<col>H（CUP）有何不同？

VPA（\x1b[Pn d）把光标设为第 Pn 行，*同时保留当前列*。CUP（\x1b[Pn1;Pn2 H）同时设置行与列。绘制纵向侧边栏 / 滚动条 / 列对齐状态指示时，VPA 让你逐行下移而不必每行重算列。两者行号均按 ECMA-48 从 1 起计；\x1b[1d 到第 1 行。需要在屏边夹紧时，终端会代为处理（多数夹紧到第 1 行 / 第 LINES 行）。

\x1b[<n>d（VPA）是从 0 起还是从 1 起？

从 1 起，与 CUP 一致。\x1b[1d 是第 1 行；\x1b[0d *不*是第 1 行 —— Pn=0 按 ECMA-48 被视作 Pn=1（多数终端静默夹紧；少数遗留解析器直接拒收）。省略 Pn 同样默认为 1：\x1b[d 等同 \x1b[1d。CUP / HVP / CHA 上同样的陷阱见 cup-1-based-not-0-based 误区条目。