DECLL —— 加载 LED 灯（`CSI Ps q`，无 SP 中间字节）

字节形式

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

说明

DECLL（*加载 LED*，\x1b[<Ps>q）控制 DEC VT100 系列终端键盘前面板的四只 LED（L1、L2、L3、L4）—— 功能键行下方的小灯，主机可点亮以呈现状态（caps lock、模式标记、注意提示）。该序列在 2026 年仍存活，仅因 Linux 控制台把自己的三只键盘 LED（NumLock、CapsLock、ScrollLock）接到它上，且 terminfo 的 KEYBOARD_LED 1/2/3 在 linux-* 条目中仍展开为 DECLL。

消歧陷阱。 DECLL 是 CSI Ps q，无中间字节。dec-cursor-shape（DECSCUSR）是 CSI Ps SP q —— 注意 空格（0x20）中间字节。一个把空白扁平化的解析器会把二者合一，于是主机想切状态 LED 时却改了光标形状。字节流 \x1b[3q 是 DECLL「L3 亮」；\x1b[3 q（带真空格）是 DECSCUSR「下划线闪烁光标」。真正的 terminfo setab / setaf 串发 DECLL 时不带空格；写解析器时请按中间字节槽位区分，而非按末字节。

参数编码（DEC VT100）： - 0 —— 全部 LED 灭（省略 Ps 时默认；也作为从部分点亮状态「重置」） - 1 —— L1 亮（Linux 控制台的 NumLock；真 VT100 的「L1」灯） - 2 —— L2 亮（Linux 控制台的 CapsLock；VT100 的「L2」灯） - 3 —— L3 亮（Linux 控制台的 ScrollLock；VT100 的「L3」灯） - 4 —— L4 亮（Linux 无映射；VT100 的「L4」灯 —— 历史上主机程序用作「需注意」） - 21 —— L1 灭（单独关一只 LED，不影响其它） - 22 —— L2 灭 - 23 —— L3 灭 - 24 —— L4 灭

语义。 DECLL 是*累加性*的 —— \x1b[1q 仅点 L1，不动 L2/L3/L4。「关」码（21–24）同样作用于单只 LED。只有 \x1b[0q（或无参数的 \x1b[q，默认 Ps=0）一次清空四只。

边界 - 单序列内允许多参数：\x1b[1;3q 同时点 L1 + L3，关码同样可组合：\x1b[21;22;23q 一次关 L1、L2、L3。（这是少数 ECMA-48「每个 Ps 应用相同末字节语义」的解读真正契合 DEC 原意的场景之一。） - Linux 控制台的内核驱动要求 CAP_SYS_TTY_CONFIG 才能从内核外部点 LED；普通用户态向 /dev/tty 写 DECLL 仅当终端类型为 linux 且 loadkeys 未重映射 LED 位时有效。 - 在 xterm 上，DECLL 切换标题栏区域的小指示点（通过 showLed X 资源配置）。默认关（无可视反馈），需用户启用。 - 勿与：dec-cursor-shape（CSI Ps SP q —— 加空格中间字节）或 xtversion（CSI > q —— 加 > 参数前缀，无 Ps）混淆。

覆盖度 —— xterm = 完整（需 showLed X 资源启用可视反馈）。Linux console = 完整（驱动内核管理的三只 LED）。mlterm + Konsole = 部分（解析 + 确认，无可视反馈除非配 X 资源）。WezTerm + iTerm2 + Kitty + Alacritty + Ghostty + Windows Terminal + cmd / ConPTY + macOS Terminal + gnome-terminal = 无作用（静默解析丢弃 —— 2026 的 GUI 模拟器无硬件 LED 可控）。实际上 DECLL 在现代栈里不可见 —— 想做可视状态指示请改用 osc-set-fg-bg / osc-cursor-color / 状态栏文本。

规范出处: DEC VT100 User Guide §5.4 (DECLL) / ECMA-48 §8.3.69 (LL — Load LEDs)

参数

示例

# Light L1 (NumLock on Linux console).\nprintf '\\033[1q'\n# Light L1 + L3 in one shot.\nprintf '\\033[1;3q'\n# Clear all LEDs.\nprintf '\\033[0q'\n# Mind the disambiguation: \\x1b[3 q is DECSCUSR (cursor blinking underline), not DECLL.\nprintf '\\033[3q'   # DECLL L3 on\nprintf '\\033[3 q'  # DECSCUSR — note literal space

import sys\n# Use DECLL as a poor-man's status indicator on a serial console.\ndef set_leds(*on):\n    if not on: sys.stdout.write('\\x1b[0q'); return\n    sys.stdout.write('\\x1b[' + ';'.join(str(i) for i in on) + 'q')\n    sys.stdout.flush()\nset_leds(1, 3)   # L1 + L3 on\nset_leds()       # all off

// Toggle Linux console NumLock LED based on app state.\nfunc setNumLock(on bool) {\n    if on {\n        fmt.Print(\"\\x1b[1q\")    // L1 on\n    } else {\n        fmt.Print(\"\\x1b[21q\")   // L1 off (don't touch L2/L3)\n    }\n}

// Avoid the DECSCUSR collision: emit DECLL with NO space between Ps and 'q'.\nfunction decll(...ps) {\n  const body = ps.length === 0 ? '0' : ps.join(';');\n  process.stdout.write('\\x1b[' + body + 'q');  // no space — DECLL, not DECSCUSR\n}\ndecll(1, 3);   // L1 + L3 on

/* DECLL on Linux console — L1 corresponds to NumLock LED. */\n#include <stdio.h>\nvoid set_status_led(int led, int on) {\n    if (on)  printf(\"\\x1b[%dq\", led);          /* 1..4 = on */\n    else     printf(\"\\x1b[%dq\", 20 + led);     /* 21..24 = off */\n    fflush(stdout);\n}

终端支持

xterm

支持

Linux console (fbcon)

支持

macOS Terminal.app

不支持

iTerm2

不支持

Windows Terminal

不支持

cmd.exe / ConPTY

不支持

kitty

不支持

alacritty

不支持

WezTerm

不支持

Ghostty

不支持

GNOME Terminal

不支持

Konsole

部分

tmux

支持

GNU screen

支持

相关序列

• DECSCUSR — 光标形状
• XTVERSION — 上报终端名称与版本（CSI > Pp q）
• DECSTR 副作用 —— `\x1b[!p` 究竟重置哪些模式
• C1 控制字符 —— ESC 序列的 8 位单字节等价形式（0x80–0x9F）