SGR 冒号子参数 — ITU-T T.416 替代写法（38:2:: / 48:2:: / 38:5:）

字节形式

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

说明

**ITU-T 建议书 T.416 / ISO/IEC 8613-6**（1993）—— SGR 子参数的冒号分隔写法。xterm 最初引入扩展颜色时全程使用分号（`\x1b[38;2;R;G;Bm`），而正式标准保留 `:`（0x3a）作为**子参数分隔符**（同一个 SGR 参数内部），`;`（0x3b）作为**参数分隔符**（独立 SGR 代码之间）。形式如下： - **24 位真彩色**：`\x1b[38:2::R:G:Bm`（前景）/ `\x1b[48:2::R:G:Bm`（背景）。`2` 后的空槽（构成 `::`）是可选的**色彩空间 ID** —— 空表示 RGB，但 T.416 允许 `38:2:Pcs:R:G:B`，其中 Pcs 标识 CIE Lab / CIE u'v'L' 等。多数模拟器忽略 Pcs，把该槽当装饰。 - **256 色**：`\x1b[38:5:Nm` / `\x1b[48:5:Nm`。注意：`5` 与 `N` 之间只有**一个**冒号 —— 没有 `::` 空槽，因为 256 色形式没有色彩空间参数。 - **CMY**（`38:3:Pcs:C:M:Y`）和 **CMYK**（`38:4:Pcs:C:M:Y:K`）变体在 T.416 中存在但基本无人实现。 **为何重要**：xterm 原始形式 `\x1b[38;2;R;G;Bm` 对严格遵循 SGR 的解析器**有歧义**。每个分号分隔的 token 本应是独立的 SGR 代码，严格解析器把 `38;2;R;G;B` 看成五个独立代码：`38`（把前景设为下一项）、`2`（可能解为「淡显」！）、然后 `R G B` 又作为 SGR 代码。冒号形式 `38:2::R:G:B` 无歧义，因为整个复合是一个**单参数**含子 token —— 冒号清晰地嵌套在 `38` 之下。一致性现状： - **支持冒号形式**：kitty（0.17 起）、foot、WezTerm、alacritty（0.10 起）、ghostty、iTerm2、mlterm、konsole 22.04+、xterm 273+、最新 gnome-terminal。 - **仅支持分号形式**：极老的模拟器、较旧的 Windows ConPTY、部分嵌入式 VT 克隆。 - **两者皆支持**：上一列表中所有现代模拟器 —— 它们在真彩色 / 256 色槽中将 `;` 与 `:` 视为等价以免破坏既有软件。 T.416 还为 **SGR 4 下划线样式**定义了冒号子参数 —— `\x1b[4:0m`（无）、`\x1b[4:1m`（单线，同 `4m`）、`\x1b[4:2m`（双线）、`\x1b[4:3m`（卷曲 / 波浪）、`\x1b[4:4m`（点状）、`\x1b[4:5m`（虚线）—— 以及下划线颜色对 `\x1b[58:2::R:G:Bm`（下划线颜色设为 RGB）/ `\x1b[59m`（恢复默认下划线颜色）。波浪下划线是这里的杀手特性 —— 终端层的 IDE 风「拼写错误」视觉。 面向可移植软件：安全模式是**发分号形式**（每个模拟器都还认得），但在消费任意日志文件的 ANSI 字节时**两种形式都解析**。

规范出处: ITU-T Rec. T.416 (ISO/IEC 8613-6) / xterm-ctlseqs (SGR Pm)

参数

示例

# Strict T.416 truecolor (note the `::`):\nprintf '\033[38:2::255:128:64morange text\033[0m\n'\n# Curly underline for spell-check overlays:\nprintf '\033[4:3mtypo\033[0m\n'

import sys\nRGB = (255, 128, 64)\nsys.stdout.write(f'\x1b[38:2::{RGB[0]}:{RGB[1]}:{RGB[2]}morange\x1b[0m\n')\n# Underline colour (T.416 58 / 59):\nsys.stdout.write('\x1b[4m\x1b[58:2::255:0:0merror\x1b[59m\x1b[24m\n')

// Emit semicolon form (most portable) but parse both:\nfmt.Print("\x1b[38;2;255;128;64morange\x1b[0m\n")\n// T.416 strict form:\nfmt.Print("\x1b[38:2::255:128:64morange\x1b[0m\n")

// Curly underline + RGB underline colour:\nprocess.stdout.write('\x1b[4:3m\x1b[58:2::200:80:80mmisspelled\x1b[59m\x1b[24m\n')

/* T.416 256-color: single colon, no empty slot: */\nprintf("\x1b[38:5:208morange-216\x1b[0m\n");\n/* Truecolor with empty colorspace slot: */\nprintf("\x1b[48:2::20:20:60mdeep blue bg\x1b[0m\n");

终端支持

xterm

支持

Linux console (fbcon)

不支持

macOS Terminal.app

不支持

iTerm2

支持

Windows Terminal

部分

cmd.exe / ConPTY

不支持

kitty

支持

alacritty

支持

WezTerm

支持

Ghostty

支持

GNOME Terminal

支持

Konsole

支持

tmux

不支持

GNU screen

不支持

相关序列

• SGR 38;2;R;G;B — 24 位真彩色前景
• SGR 48;2;R;G;B — 24 位真彩色背景
• SGR 38;5;n — 256 色前景
• SGR 48;5;n — 256 色背景
• SGR 4 — 下划线

在家族食谱中

↗SGR 食谱 · 6. SGR 冒号子参数 —— 真正符合标准的写法