前言

正常情況下，使用 printf 向串口打印調試信息，在串口調試工具界面只能看到一種顏色的字符，且使用不同的串口調試工具，字符默認的顏色都不一樣。

如果你在 VSCode 上使用過 ESP-IDF 開發 ESP32 應用程序，你會發現其終端上輸出的調試信息是五顏六色的，十分花哨。 而且不同類型的調試信息使用不同的顏色區分，能夠快速地定位到程序中的問題，非常便捷實用。

那么我們使用 printf 函數通過串口能否輸出彩色的調試信息呢？ 答案是肯定的，只是需要一丟丟小技巧罷了。

ANSI 轉義序列

在介紹如何打印彩色調試信息之前，我們先來了解一些背景知識 —— ANSI 轉義序列。

我們將信息打印到終端上顯示時，可以控制信息顯示成粗體、斜體、下劃線等形式，也可以控制字符顯示不同的顏色。

例如執行如下代碼，會在終端上顯示紅色 ---testing---：

printf("\\033[31m---testing---\\n");

為什么有些字符會被當做信息顯示，有些字符會被當做命令處理？ 其實這一切都歸功于轉義字符。

在C語言中，用反斜杠 "" 作為轉義字符，正常情況下，"" 和 "n" 都是普通的字符，但是將這兩個字符組合起來變成 "\\n" 的字符序列后，就表示換行符了。

在終端中也有類似的用法，只不過終端中的轉義字符不是反斜杠 "" ，而是 "ESC"。 終端使用 "ESC" 作為轉義字符，而 "ESC" 在 ASCII 表中的序號是 27，也就是 0x1b，因此終端中與 0x1b 組合起來的字符序列就會被轉義成命令，不同的字符組合表示不同的終端命令，這些轉義規則被規范化以后，就叫做 ANSI 轉義序列（ANSI Escape Sequences）， 主要用來控制終端上光標位置、顏色及其他選項。

ANSI 轉義序列起始標志

ANSI 轉義序列起始標志由兩個字節組成，第一個字節是終端轉義字符 "ESC" 也就是 0x1b，第二個字節的取值范圍是0x40–0x5F（即 ASCII：@ A – Z [ \\ ] ^ _），也就是說 ANSI 轉義序列的起始標志共有如下幾種：

• x1b@（ESC@）
• x1bA（掃描）
• x1b-（電調-）
• x1bZ（ESCZ）
• x1b[（ESC[）
• x1b\\（ESC\\）
• x1b]（ESC]）
• x1b^（ESC^）
• x1b_（ESC_）

上述那么多種起始標志，常見的起始標志就是 " x1b[ " ，其他的起始標志現在都很少用到了。

控制符起始標志 CSI

當 0x1b 與 "[" 組合時，就叫做控制符起始標志（Control Sequence Introducer），簡稱為 CSI ，其基本格式如下：

x1b[<code><tail>

code: 轉義序列的具體內容，多個內容之間使用分號 ";" 隔開

tail : 轉義序列結束標志，不同 tail 表示不同功能的序列

以 CSI 開頭的轉義序列有很多，不同的序列表示不同的終端指令，大致可以分為如下幾類：

• 字符渲染指令（SGR）
• 光標移動指令
• 清屏指令
• 終端控制指令

字符渲染指令

字符渲指令（Select Graphic Rendition），簡稱為 SGR 。主要用于設置字符顯示效果，其基本格式如下：

CSI編號

CSI：控制符起始標志 " 0x1b[ "

n ：取值范圍 0 ~ 107

m ：轉義序列結束標志，字母 m 作為結尾，表明是字符渲染序列

示例：

x1b[3m

n 的取值范圍是 0 ~ 107，主要分為如下兩類功能：

• 字符樣式控制
• 字符顏色控制

n 的取值及說明：

有了上述這些背景知識，就足夠搞懂串口輸出彩色調試信息的原理了，關于 ANSI 轉義序列的更多內容，感興趣的小伙伴可以自行查閱。

串口輸出彩色調試信息

在 《單片機 printf 重定向串口輸出調試信息》這篇文章中介紹了如何使用 printf 通過串口輸出調試信息，那么現在就在此基礎上，再說說如何將輸出的調試信息變成彩色的。

通過串口輸出彩色調試信息有兩個必要條件:

• printf 參數列表中添加字符顏色控制相關的 ANSI轉義序列
• 接收串口數據的串口調試工具支持 ANSI 轉義序列解析

回顧一下上面講到的字符渲指令（SGR），其基本格式如下：

CSI n m

CSI：控制符起始標志 " 0x1b[ "

n ：取值范圍 0 ~ 107

m ：轉義序列結束標志，字母 m 作為結尾，表明是字符渲染序列

當我們想要輸出不同顏色的字符時，將 n 替換成對應的數字即可，常見的顏色如下：

使用 printf 打印 "Hello World" 代碼如下：

printf("Hello World\\n");

打印不同的 "Hello World" 代碼如下：

printf("\\x1b[31m" "Hello World\\n" "\\x1b[0m"); 
printf("\\x1b[32m" "Hello World\\n" "\\x1b[0m"); 
printf("\\x1b[33m" "Hello World\\n" "\\x1b[0m"); 
printf("\\x1b[34m" "Hello World\\n" "\\x1b[0m"); 
printf("\\x1b[35m" "Hello World\\n" "\\x1b[0m");
printf("\\x1b[36m" "Hello World\\n" "\\x1b[0m");

注意事項

如果使用的串口調試工具不支持 ANSI 轉義序列解析，那么接收到的串口數據會有部分亂碼，而且只會使用工具默認的顏色顯示信息：

支持 ANSI 轉義序列解析的串口調試工具才能正常顯示彩色字符，推薦使用 MobaXterm 。