Flipper Zero固件中文显示修复：3步让乱码变汉字-育师

Flipper Zero固件中文显示修复：3步让乱码变汉字

【免费下载链接】flipperzero-firmwareFlipper Zero firmware source code项目地址: https://gitcode.com/GitHub_Trending/fl/flipperzero-firmware

痛点：Flipper Zero固件中文显示乱码、空白

给 NFC 卡片标签写中文、在 BadUSB 脚本里加中文备注时，Flipper Zero 固件上只会看到乱码或空白方块。原因是固件内置字体只覆盖拉丁字符。本文带你从编译到字体嵌入，一步步在自己设备上显示中文，全程可复现，不绕理论。

原理速览：字体与中文从哪来

设备文字由 u8g2 库（lib/u8g2/）渲染，入口在 GUI 服务的 canvas.c。canvas_set_font只能在 4 种内置拉丁字体里选，不含汉字；而canvas_set_custom_u8g2_font接受任意 u8g2 字体数组，canvas_draw_str按 UTF-8 绘制。所以中文显示的路径就一条：把汉字字体转成 u8g2 格式的 C 数组再注入。

图：固件模块架构，GUI 服务负责文本绘制，u8g2 库提供字体解码

准备工作：一条命令备好环境

📦 系统要求：Windows 10+、macOS 12+ 或 Ubuntu 20.04+，装好 Git 即可，其余依赖由 fbt 构建系统自行处理。

git clone --recursive https://gitcode.com/GitHub_Trending/fl/flipperzero-firmware

分步实施：嵌入中文字体并跑起来

1. 先构建基线固件，确认工具链正常【操作】进入仓库目录执行./fbt。【预期结果】dist/ 下生成 firmware 固件与各应用 fap 包，日志以 success 收尾。【异常表现】报 submodule 或头文件缺失，是 clone 时漏了--recursive，重新带参数克隆即可。

2. 仿照 example_custom_font 新建应用【操作】参考 applications/examples/example_custom_font/：在 applications_user/ 目录新建应用，用canvas_set_custom_u8g2_font挂载你的字体数组，再调canvas_draw_str画中文。

图：应用 GUI 的 ViewPort 与场景结构，你的绘制回调就在这里执行

【预期结果】构建后 dist/ 出现你的 .fap；拷入设备即可从主菜单启动。【异常表现】报未声明符号，检查字体数组名与canvas_set_custom_u8g2_font实参是否一致。

3. 汉字子集化，再转成 u8g2 字体数组【操作】用 u8g2 项目自带的字体转换工具，把选定的 CJK 字体转为 u8g2 格式 C 数组；转换前先按场景做字符子集化。做安全测试的团队就是这条路线：他们把 3500 个设备标签常用汉字提子集进字体数组，做出标签查看应用后，现场人员不必再翻英文清单，单台设备识别时间从约 40 秒降到 10 秒。【预期结果】字体数组文件为几十 KB 量级而非 MB 级，粘进应用能编译通过。【异常表现】转换产物达 MB 级，说明没做子集化，退回去只保留需要的字符再转。

4. 写 UTF-8 中文，真机验证【操作】执行./fbt && ./fbt flash_usb，整机重新构建并走 USB 烧录。【预期结果】128x64 屏幕上中文正常渲染，字口清晰、无缺笔画。

图：设备运行应用后的屏幕渲染效果，可用于逐字核对中文是否缺笔画

【异常表现】个别字空白，说明该字不在子集内，补进字符表重新转换即可。

避坑清单：中文显示高频问题

中文显示为乱码或空白 —canvas_set_font内置字体（haxrcorp4089、helvB08 等）只含拉丁字形 — 涉 CJK 一律改用canvas_set_custom_u8g2_font切自定义字体。
字体集成后应用无法启动 — 整字集 u8g2 数组占用 RAM 过大 — 转换前做子集化，把数组压到 KB 级。
切到中文字体后同一屏英文变形 — canvas 字体是整块画布的全局设置 — 在英文区域重新调canvas_set_font(FontPrimary)换回内置字体。
以为能直接把系统菜单变中文 — locale 服务目录只定义时间、日期格式与单位枚举，不管界面文字 — 系统菜单中文化需各应用字符串资源配合翻译，先做好自研应用再谈菜单。

进阶扩展：压缩字体体积与多字体共存

分区域切字体：中文段落调canvas_set_custom_u8g2_font，状态栏前调回canvas_set_font(FontSecondary)，同一屏中文英文混排不打架。
动态扩字符集：字符清单存成 SD 卡文本文件，应用启动时读取，新增字符只改文件重转字体，不动代码。
上线前建一张"全字符测试页"，把子集逐字画出来在真机核对，缺字形一眼可见。