terminfo 能力 → ANSI 转义码对照
ncurses / terminfo 能力名（即传给 tput 的参数）在现代 xterm-256color 终端上展开成的 ANSI / VT 转义序列。把老 shell 脚本从 tput 迁移到裸字节、调试 TUI 输出的「错误字节」，或者只是想搞清楚 tput setaf 1 到底发送了什么时，可以查这张表。
属性（SGR）
| tput 能力名 | terminfo 全称 | 序列 | 说明 |
|---|---|---|---|
| sgr0 | exit_attribute_mode | \x1b[0m | 重置所有文本属性与颜色，等价于 SGR 0。开启任意属性后都应配套使用。 — SGR 0 — 重置 / 恢复默认 |
| bold | enter_bold_mode | \x1b[1m | 加粗 / 高亮。使用 sgr0 或 SGR 22 关闭。 — SGR 1 — 加粗 / 高亮 |
| dim | enter_dim_mode | \x1b[2m | 半亮（弱化）。SGR 2。 — SGR 2 — 暗淡 / 减弱 |
| sitm | enter_italics_mode | \x1b[3m | 斜体。多数现代终端支持，Linux 控制台与 cmd.exe 不支持。 — SGR 3 — 斜体 |
| ritm | exit_italics_mode | \x1b[23m | 在不清除其他属性的前提下关闭斜体。 — SGR 3 — 斜体 |
| smul | enter_underline_mode | \x1b[4m | 开启下划线。SGR 4。 — SGR 4 — 下划线 |
| rmul | exit_underline_mode | \x1b[24m | 关闭下划线（SGR 24），其他属性保留。 — SGR 4 — 下划线 |
| blink | enter_blink_mode | \x1b[5m | 慢闪烁。iTerm2 / kitty 等默认关闭；通常体验不佳，建议改用颜色变化。 — SGR 5 — 闪烁（慢速） |
| rev | enter_reverse_mode | \x1b[7m | 反相视频 —— 前景色与背景色对调。SGR 7。 — SGR 7 — 反相显示 |
| smso | enter_standout_mode | \x1b[7m | Standout —— 历史上与反相不同，现代终端统一映射为 SGR 7（反相）。 — SGR 7 — 反相显示 |
| rmso | exit_standout_mode | \x1b[27m | 通过 SGR 27 退出 standout / 反相，仅清除该属性。 — SGR 7 — 反相显示 |
| invis | enter_secure_mode | \x1b[8m | 隐藏文本（SGR 8）。可用于显示掩码密码，但仍可被复制。 — SGR 8 — 隐藏 / 不可见 |
颜色
| tput 能力名 | terminfo 全称 | 序列 | 说明 |
|---|---|---|---|
| setaf | set_a_foreground | varies | 按索引设置前景色。tput setaf 1 → \x1b[31m（红）；tput setaf 9 → \x1b[91m（亮红）；256 色与 TrueColor 终端接受更高索引。 — SGR 30–37 — 前景色（8 种基础色） |
| setab | set_a_background | varies | 按索引设置背景色 —— setaf 的镜像。 — SGR 40–47 — 背景色（8 种基础色） |
| op | orig_pair | \x1b[39;49m | 将前景色与背景色同时恢复为终端默认，不影响其他 SGR 状态。 — SGR 39 — 默认前景色 |
光标
| tput 能力名 | terminfo 全称 | 序列 | 说明 |
|---|---|---|---|
| cup | cursor_address | varies | 将光标移动到 (row, col)；terminfo 层 0 索引，最终输出为 1 索引的 \x1b[<r+1>;<c+1>H（CUP）。 — CUP — 设置光标位置 |
| home | cursor_home | \x1b[H | 光标回到 (1, 1)。 — CUP — 设置光标位置 |
| cuu1 | cursor_up | \x1b[A | 向上 1 行（CUU 1）。 — CUU / CUD / CUF / CUB — 移动光标 |
| cud1 | cursor_down | \n | 向下 1 行 —— 多数现代 terminfo 中即为 \n（LF）。多行使用参数化 cud：\x1b[NB。 — CUU / CUD / CUF / CUB — 移动光标 |
| cuf1 | cursor_right | \x1b[C | 向右 1 列（CUF 1）。 — CUU / CUD / CUF / CUB — 移动光标 |
| cub1 | cursor_left | \b | 向左 1 列 —— terminfo 通常映射为裸 BS（\b，0x08）。多列使用 cub：\x1b[ND。 — CUU / CUD / CUF / CUB — 移动光标 |
| hpa | column_address | varies | 在当前行移动到指定列 —— \x1b[<col+1>G（CHA）。 — CHA — 光标水平绝对位置（列） |
| civis | cursor_invisible | \x1b[?25l | 隐藏文本光标。退出时务必配套 cnorm。 — DECTCEM ?25 — 显示/隐藏光标 |
| cnorm | cursor_normal | \x1b[?25h | 恢复文本光标（DECTCEM ?25h）。 — DECTCEM ?25 — 显示/隐藏光标 |
| sc | save_cursor | \x1b7 | 保存光标位置（DECSC）。与 rc 配套。 — DECSC / DECRC — 保存与恢复光标 |
| rc | restore_cursor | \x1b8 | 恢复 sc 之前保存的光标位置（DECRC）。 — DECSC / DECRC — 保存与恢复光标 |
擦除
| tput 能力名 | terminfo 全称 | 序列 | 说明 |
|---|---|---|---|
| clear | clear_screen | \x1b[H\x1b[2J | 光标归位后清除整个显示区域（ED 2）。shell 命令 clear 最终发送的就是它。 — ED — 清屏 (`\x1b[2J`) |
| ed | clr_eos | \x1b[J | 从光标位置擦除到显示区域末尾（ED 0，默认）。 — ED — 清屏 (`\x1b[2J`) |
| el | clr_eol | \x1b[K | 从光标位置擦除到行尾（EL 0）。进度条惯用「\r + el」。 — EL — 行内擦除 (`\x1b[K`) |
| el1 | clr_bol | \x1b[1K | 从行首擦除到光标（EL 1）。 — EL — 行内擦除 (`\x1b[K`) |
屏幕 / 模式
| tput 能力名 | terminfo 全称 | 序列 | 说明 |
|---|---|---|---|
| smcup | enter_ca_mode | \x1b[?1049h | 进入备用屏幕缓冲。vim、less、htop、top 启动时发送它。 — DECSET 1049 — 备用屏幕缓冲 |
| rmcup | exit_ca_mode | \x1b[?1049l | 离开备用屏幕缓冲 —— 恢复原缓冲与光标。 — DECSET 1049 — 备用屏幕缓冲 |
| reset | reset_1string (rs1) | \x1bc | 终端硬重置 —— 发送 RIS（\x1bc）。tput reset 与 reset(1) 最终发送的内容。 — RIS — 重置到初始状态（终端硬重置） |
输入（键盘）
| tput 能力名 | terminfo 全称 | 序列 | 说明 |
|---|---|---|---|
| kcuu1 | key_up | \x1b[A (\x1bOA in DECCKM application mode) | 上方向键。常规光标键模式发 \x1b[A；应用通过 smkx 打开 DECCKM 后发 \x1bOA（SS3）。vim、less 等同时绑定两形。 — CUU / CUD / CUF / CUB — 移动光标 |
| kcud1 | key_down | \x1b[B (\x1bOB in app mode) | 下方向键。DECCKM 切换同 kcuu1。修饰键在末字母前以 ;<mod> 追加：Shift+Down = \x1b[1;2B。 — CUU / CUD / CUF / CUB — 移动光标 |
| kcub1 | key_left | \x1b[D (\x1bOD in app mode) | 左方向键。Bash readline 默认把 \e[D 绑到 backward-char —— 同字节流，只是在输入侧解读。 — CUU / CUD / CUF / CUB — 移动光标 |
| kcuf1 | key_right | \x1b[C (\x1bOC in app mode) | 右方向键。在 bindkey/inputrc 中与 kcub1（左）配对，绑定 forward-char/backward-char。 — CUU / CUD / CUF / CUB — 移动光标 |
| khome | key_home | \x1bOH (or \x1b[1~ on rxvt-class) | Home 键。xterm 类发 \x1bOH（SS3 H）；rxvt 类发 \x1b[1~。多数 readline 配置同时绑 \e[H。 — CUP — 设置光标位置 |
| kend | key_end | \x1bOF (or \x1b[4~ on rxvt-class) | End 键。xterm 类 \x1bOF；rxvt 类 \x1b[4~。在输入绑定表中与 khome 配对。 — CUP — 设置光标位置 |
| kpp | key_ppage | \x1b[5~ | PageUp。5~ 的 CSI 波浪号编码在 xterm / rxvt / Linux 控制台间通用。修饰键：Shift+PgUp = \x1b[5;2~。 |
| knp | key_npage | \x1b[6~ | PageDown。与 kpp 镜像，选择子 6。Linux 控制台在某些模式下可能发遗留的 \x1b[G —— 查 infocmp linux。 |
| kbs | key_backspace | \x7f (or \x08 on Linux console / cmd.exe) | 退格。著名分叉：xterm / iTerm2 / Windows Terminal 发 \x7f（DEL）；Linux 控制台 + cmd.exe 发 \x08（BS）。inputrc 中应同时绑两者。 |
| kdch1 | key_dc | \x1b[3~ | Delete 键（向前删，不是退格）。3~ 选择子。Shift+Delete = \x1b[3;2~。勿与 kbs 混淆。 |
| kich1 | key_ic | \x1b[2~ | Insert 键。2~ 选择子。部分模拟器（macOS Terminal）无物理 Insert 键，但仍可由 fn-Enter 或自定义快捷键触发 \x1b[2~。 |
| kf1 | key_f1 | \x1bOP | F1。F1–F4 用 SS3 形（\x1bO + 字母 P/Q/R/S）—— DEC VT100 Help / Do 键的历史遗留。F5+ 改用 CSI 波浪号。 |
| kf5 | key_f5 | \x1b[15~ | F5。带跳号的 CSI 波浪号编码登场：F5=15~、F6=17~（跳 16）、F7=18~、F8=19~、F9=20~、F10=21~、F11=23~（跳 22）、F12=24~。 |
| kf12 | key_f12 | \x1b[24~ | F12。F 键家族尾端。现代键盘鲜有 F13+ 物理键，但 terminfo 定义到 kf63 —— 按 xterm 传统这些是组合键重映射（Shift+F1 = F13，等）。 |
| smkx | keypad_xmit | \x1b[?1h\x1b= | 进入应用键盘模式 —— 翻 DECCKM（\x1b[?1h）让方向键发 SS3 形（\x1bOA..），再 DECKPAM（\x1b=）让数字键盘发带 SS3 前缀码。vim / less / fzf 启动时发此串。 — DECKPAM / DECKPNM — 小键盘应用 / 数字模式（ESC = / ESC >） |
| rmkx | keypad_local | \x1b[?1l\x1b> | 退出应用键盘模式 —— DECCKM 关（\x1b[?1l）+ DECKPNM（\x1b>）。应用退出时应当发此串；vim 崩溃 / 偷懒的 SIGINT 处理器跳过此步会把终端留在应用模式（方向键发 \eOA 而非 \e[A，破坏 readline 风格输入）。 — DECKPAM / DECKPNM — 小键盘应用 / 数字模式（ESC = / ESC >） |
用法
在任何类 Unix 系统上，infocmp -1 <term> 会输出该终端的完整能力表。脚本中使用 tput <cap> 会基于 $TERM 查询并输出字节，可在 xterm / Linux console / macOS Terminal / kitty / wezterm 间可移植运行，对 dumb 终端也能优雅降级。
# print the underlying escape for any cap:
infocmp -1 xterm-256color | grep -E '^\s(setaf|cup|civis|smcup)='
# emit a cap from a shell script:
RED=$(tput setaf 1)
BOLD=$(tput bold)
RESET=$(tput sgr0)
printf '%s%serror:%s permission denied\n' "$BOLD" "$RED" "$RESET"