轻松搞定嵌入式中文显示u8g2_wqy 中文字体库完整上手指南【免费下载链接】u8g2_wqy适合 u8g2 的中文字体采用文泉驿点阵宋体作为源本提供 12x12、13x13、14x14、15x15 和 16x16 点阵字库。项目地址: https://gitcode.com/gh_mirrors/u8/u8g2_wqy去年夏天我在一个 ESP32 温控器项目里被中文显示卡住了整整两周。OLED 屏要显示当前温度25.5℃可 u8g2 自带的字体一个汉字都没有自己写脚本逐字抠位图字是出来了却糊成一团8 个汉字就吞掉 6KB Flash想加个进度条都得精打细算。直到我在仓库里翻到 u8g2_wqy——一套专为 u8g2 图形库准备的中文字体库——困扰才真正解除。u8g2_wqy 以文泉驿点阵宋体为源本提供 12x12 到 16x16 共 5 种点阵尺寸、6 档字符集把嵌入式中文显示从两周的苦力活变成三分钟的配置。它适合所有用 u8g2 驱动 OLED/LCD、需要在低资源 MCU 上显示中文的开发者和自己抠字模或购买商业字库的方案相比开源免费、即拷即用、体积可控是它最大的区别。30 秒认识核心能力⚡️ 5 种点阵尺寸12-16px从 128x32 小屏到 160x128 大屏都能匹配✅ 6 档字符集从 411 字精简版到 7539 字完整 GB2312源码即字库src/下两个文件拷进工程就能编译零额外依赖字体配置字符数12px 字节占用wqy12_t_chinese14119,491wqy12_t_chinese399325,038wqy12_t_gb23127,539208,228其他尺寸13-16px下 chinese2、gb2312a、gb2312b 的完整字节数README 里都一一列好了。三步完成接入最小可行路径拿到手立刻能用全程不超过十分钟获取代码git clone https://gitcode.com/gh_mirrors/u8/u8g2_wqy把src/u8g2_wqy.h和src/u8g2_font_wqy.c放进工程#include u8g2_wqy.h设置字体后正常绘制即可#include u8g2_wqy.h u8g2.setFont(u8g2_font_wqy12_t_chinese1); u8g2.drawStr(0, 12, 你好世界);字体名里的12是点阵尺寸、chinese1是字符集代号调用方式与 u8g2 其他字体完全一致不需要学习任何新 API。进阶玩法按需定制你的汉字库按 Flash 余量选字符集。Flash 紧张的设备选chinese1411 个最高频汉字足够覆盖日常提示语功能型产品用chinese3993 字在覆盖与体积间取平衡需要完整 GB2312 简体中文编码、又不惧 200KB 占用的大 Flash 设备才上gb2312全集。用源文件重新生成。仓库保留了 bdf 目录下的 5 个点阵源文件9pt 到 13px、maps 目录的字符映射表以及转换工具 bdfconv.exe。想换尺寸、想调整字符组合跑一遍 bdf maps 的转换流程即可genmaps.sh 演示了映射表的生成方式全程可控。内存占用不用操心。头文件里对 AVR 平台自动启用.progmem段、对 ESP8266 使用.text段字库数据默认落在 Flash 而非 RAM开发者无需手动干预。常见误区与避坑如何避免存储爆满误区一字库越大越好。有人一上来就选 7539 字的 gb2312 全集208KB 直接撑爆小容量 Flash。正确做法是先列清要显示的文案从 chinese3 起步缺字再逐级升级。误区二忽略 gb2312a 的标点限制。gb2312a不含、这类全角标点必须用半角!、?代替需要全角标点就选gb2312b或完整版gb2312。误区三不看体积就切字体。字库是整体编进固件的常量数组切换前先对照 README 的字节表建议至少预留 20% Flash 余量避免后期加功能时无空间可用。常见问题快速解答Q必须搭配 u8g2 使用吗A是的这套数据是 u8g2 格式的字体需配合 u8g2 图形库调用主控型号不限。Q显示乱码怎么排查A先确认字符串是 UTF-8 编码、setFont 在 drawStr 之前调用再确认字符落在所选字符集内GB2312 之外的生僻字任何档位都显示不了。Qbdf 源文件只有 5 个怎么对应 5 档输出尺寸Abdf 目录的 9pt、10pt、11pt、12pt、13px 源文件经 bdfconv.exe 转换后对应生成 12 到 16px 五档字库。Qchinese 系列和 gb2312 系列是什么关系Achinese1/2/3 是 u8g2 官方推荐的高频小字符集体积小、够日常用gb2312 系列覆盖完整简体中文编码字符全但占用大按需求二选一即可。Q想加自定义字符怎么办A用 bdf 源文件配合 maps 映射表重新走一遍生成流程仓库里的工具链已经齐备。下一步跑起来比想象中简单一句话总结u8g2_wqy 让嵌入式中文显示回归配置而不是造轮子。现在就 clone 一份先拿chinese1 12px 在你的板子上跑出你好世界再按实际文案和 Flash 余量逐步升级字符集。跑通之后你会发现以前那些因为显示不了中文而砍掉的需求其实都还来得及捡回来。【免费下载链接】u8g2_wqy适合 u8g2 的中文字体采用文泉驿点阵宋体作为源本提供 12x12、13x13、14x14、15x15 和 16x16 点阵字库。项目地址: https://gitcode.com/gh_mirrors/u8/u8g2_wqy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
