3. 字符映射与编码：Unicode 与字符映射表

字符映射，说白了就是解决「用户按下一个键，屏幕上该显示什么字形」的问题。在嵌入式字体渲染里，这一步要是搞错了，轻则显示乱码，重则整个 UI 崩掉。我早年做一款海外对讲机项目时就吃过这个亏——俄语菜单全变成方框，排查了两天才发现是字符索引查错了表。

这一节我们就把 Unicode、字符映射表、以及 FreeType 里最核心的 FT_Get_Char_Index 函数彻底讲透。

3.1 Unicode 与字符编码基础

先问一个问题：为什么不用 ASCII 就够？因为 ASCII 只定义了 128 个字符，连中文的「中」字都放不下。Unicode 的出现就是为了给全世界所有字符一个唯一的编号。

Unicode 本质上是一张巨大的表格，每个字符对应一个码点（Code Point），范围从 U+0000 到 U+10FFFF。比如：

字符	Unicode 码点	说明
A	U+0041	拉丁大写字母 A
中	U+4E2D	汉字「中」
あ	U+3042	日文平假名「あ」
😊	U+1F60A	Emoji 笑脸

但 Unicode 只是定义了编号，怎么存储是另一回事。这就引出了 UTF-8、UTF-16、UTF-32 这些编码方案。嵌入式系统里最常用的是 UTF-8，因为它兼容 ASCII，而且对英文文本没有空间浪费。

3.2 字符映射表（CMap）是什么

字体文件里存了成百上千个字形（Glyph），每个字形有一个索引号。但用户输入的是 Unicode 码点，不是字形索引。怎么把码点转成索引？

答案就是字符映射表（Character Map，简称 CMap）。它是一张从 Unicode 码点到字形索引的查找表，内嵌在字体文件中。FreeType 加载字体后，会解析 CMap 表并建立内部的映射关系。

常见的 CMap 格式有几种：

CMap 格式	特点	适用场景
Format 4	分段映射，适合 BMP（U+0000~U+FFFF）	中英文、日韩等常见字符集
Format 12	分段映射，支持完整 Unicode 范围	需要 Emoji、生僻字等扩展字符
Format 0	字节映射，仅 256 个条目	老旧字体或单字节字体

嗯，这里要注意：不是所有字体都包含完整的 CMap。有些精简字体只保留了 Format 4，如果你要渲染 Emoji，就得确认字体是否包含 Format 12。

3.3 FT_Get_Char_Index 函数详解

这是 FreeType 里最常用的函数之一。它的作用就是：给定一个 Unicode 码点，返回对应的字形索引。

#include <ft2build.h>
#include FT_FREETYPE_H

FT_UInt glyph_index;
glyph_index = FT_Get_Char_Index(face, char_code);

if (glyph_index == 0) {
    // 字形未找到，通常用 .notdef 字形替代
    glyph_index = FT_Get_Char_Index(face, 0);
}

函数签名很简单，但有几个坑我必须提醒你：

• 返回 0 表示未找到：FreeType 里字形索引 0 通常对应 .notdef 字形（一个方框或问号）。如果你传入的码点在字体里不存在，返回的就是 0。
• 多字体回退：一个字体文件可能包含多个 CMap 子表。FreeType 默认会选择最合适的那个，但你可以用 FT_Select_Charmap 手动指定。
• 性能问题：每次调用 FT_Get_Char_Index 都会在 CMap 里做一次查找。如果你要渲染一段长文本，建议先批量查完所有字符的索引，再统一渲染。

3.4 处理多语言字符集

嵌入式设备经常要支持多语言。比如一个智能家居面板，菜单可能是中文，但用户名字段可能包含英文、阿拉伯数字，甚至 Emoji。这时候字符映射就变得复杂了。

我建议的做法是分层处理：

1. 输入层：确保所有输入都统一成 UTF-8 编码。如果是按键输入，按键码也要映射到 Unicode 码点。
2. 映射层：对每个字符调用 FT_Get_Char_Index，如果返回 0，尝试从备用字体中查找。
3. 回退层：如果所有字体都找不到，就用 .notdef 字形占位，但要在日志里记录缺失的码点。

3.5 本章知识体系图

下面这张 SVG 图总结了字符映射与编码的核心流程：

3.6 实战建议与避坑指南

最后，分享几个我在实际项目中积累的经验：

• 缓存映射结果：如果 UI 中有固定文本（比如菜单项），在初始化时一次性查完所有字符的索引，存到数组里。运行时直接取用，避免重复查找。
• 处理缺失字符：不要假设字体一定包含所有字符。我习惯在字体加载后，先查一下常用字符（比如空格、换行、常见标点）是否存在，如果连空格都没有，说明字体加载有问题。
• 多字体回退策略：准备一个字体列表，按优先级排列。主字体找不到字符时，依次尝试备用字体。这个逻辑虽然简单，但能解决 90% 的多语言显示问题。
• 注意字体子集化：有些嵌入式字体为了省空间，只保留了部分字符。如果你要支持多语言，务必确认字体文件包含了目标语言的 CMap 表。