woff/woff2需先解压为sfnt流再交freetype加载：woff2用brotli压缩且表重排，须调用woff2::woff2decompress解压；woff1用zlib压缩，需raw inflate；解压后用ft_new_memory_face加载内存流，注意数据生命周期。
Woff/Woff2不是标准字体解析目标，C++没有内置支持
直接用 C++ 标准库或常见图形库（如 FreeType）读取 .woff/.woff2 文件会失败——FreeType 从 2.12 开始才通过第三方模块（woff 和 woff2 编解码器）提供实验性支持，且默认不启用；更早版本完全不识别这两个格式。你看到的 FT_Open_Face 返回 FT_Err_Unknown_File_Format 或直接崩溃，基本就是这个原因。
核心问题不在“怎么解析”，而在于：Woff/Woff2 是 Web 字体封装格式，本质是带压缩、元数据和表重排的 SFNT 容器（类似 TTF/OTF），必须先解包还原成 SFNT 流，再交给字体引擎处理。
必须先解压 WOFF2 才能用 FreeType 加载
WOFF2 使用 Brotli 压缩整个 SFNT 结构，且表顺序被打乱、有额外的自定义头部（WOFF2Header）。不能跳过解压步骤，也不能靠内存映射硬读。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 用官方
woff2_decompress工具验证：运行woff2_decompress font.woff2能生成font.ttf，说明原始文件合法且解压逻辑可行 - C++ 集成时，推荐直接调用
woff2::WOFF2DecompressAPI（来自 google/woff2）：它接受const uint8_t*输入和std::vector<uint8_t>&</uint8_t>输出，返回解压后的 SFNT 字节流 - 注意输入缓冲区必须完整包含整个 WOFF2 文件（含头部），且
woff2库不负责内存释放——你得自己管理输入指针生命周期 - 解压失败时，
WOFF2Decompress返回false，但不会告诉你具体错在哪；建议先用woff2_info font.woff2检查是否签名错误或校验失败
FreeType 加载解压后的字节流需绕过文件 I/O
拿到解压出的 SFNT 数据（比如存为 std::vector<uint8_t> sfnt_data</uint8_t>）后，不能写临时文件再用 FT_New_Face 加载——这低效且在沙箱环境可能被禁。要用 FreeType 的内存 face 接口：
- 调用
FT_New_Memory_Face，传入library、sfnt_data.data()、sfnt_data.size()和0（face index） - 确保
sfnt_data的生命周期长于FT_Face对象——FreeType 不复制数据，只保存指针 - 若解压后得到的是 OTF（CFF 表）而非 TTF（glyf 表），FreeType 同样能处理，无需额外判断；但某些旧版（
- 加载成功后，
face->num_glyphs、FT_Load_Char等行为与普通 TTF 完全一致
WOFF（非 WOFF2）可用 zlib 解压 + 少量头解析
WOFF1 是 zlib 压缩的 SFNT，结构比 WOFF2 简单：前 44 字节是固定头部（含压缩长度、偏移等），之后是 zlib 流。你可以手动处理，但仍有坑：
- 头部中
totalSfntSize字段指示解压后 SFNT 大小，但实际 zlib 解压结果必须严格等于该值，否则 FreeType 拒绝加载 - zlib 解压必须用
inflate（不是uncompress），且要设置INFLATE_WINDOW_BITS = -15（raw deflate，WOFF 不带 zlib header） - WOFF 中的表目录（Table Directory）可能被重排序，但解压后字节流本身是标准 SFNT，FreeType 能自动识别
- 除非你明确需要最小依赖，否则仍建议统一走
woff2库——它同时支持 WOFF1 和 WOFF2 解压（函数名相同，自动检测格式）
真正麻烦的从来不是“怎么写几行代码”，而是 WOFF2 的 Brotli 参数组合、SFNT 对齐要求、以及 FreeType 内部对表校验的严格程度——一个字节偏移不对，FT_Open_Face 就静默失败。动手前，先用命令行工具确认文件可解，比写一堆 try-catch 有用得多。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
