ESP32+Micropython实战：5分钟搞定OLED ssd1306中文显示（附完整字库生成教程）

关注

VIP免费原创最新推荐文章于 2026-09-22 15:30:47 发布 497 阅读 AI 写同款· GEO 优化 ›

SSD1306规格OLED驱动库（STM32版），包含16x16汉字、字母写入函数这里写目录标题前言OLED一、像素二、页结构纵向结构横向结构注意事项字库oled_font.h一、字库介绍二、制作字库PCtoLCD2002 前言在很多项目中OLED屏幕的使用都是很常见的，可以作为调试信息的输出以及用于用户交互。一般的项目我们只需要能实现一些简单的功能就行，比如写入汉字以及字母就行，所以我将这两个功能打包成函数，方便调用。项目工程我会放到文章最后，需要的可以下载使用。 OLED 一、像素 1、我使用的这款OLED是128x64大小的，也就是这个屏幕一共有128x64 = 8192的发阅读详情

ESP32+MicroPython实战：5分钟搞定OLED SSD1306中文显示（附完整字库生成教程）

你是否曾经兴致勃勃地想把ESP32和那块小巧的OLED屏幕连接起来，准备做一个显示天气、歌词或者智能家居状态的小玩意儿，却在显示中文时卡了壳？屏幕上只能蹦出英文和数字，一到中文就变成一堆乱码或者干脆不显示，这种感觉确实让人有点泄气。对于国内的物联网开发者和硬件爱好者来说，让OLED显示中文几乎是一个绕不开的“刚需”。毕竟，我们的项目界面、传感器标签、状态提示，用母语来表达总是最直观、最亲切的。

网上关于ESP32驱动SSD1306的教程不少，但大多停留在显示英文和简单图形的阶段。一旦涉及到中文，要么语焉不详，要么给出的方案复杂到让人望而却步，需要手动处理庞大的字库文件，动辄几百KB，对于ESP32那有限的存储空间来说是个不小的负担。今天，我们就来彻底解决这个痛点。我将分享一套经过实战检验的极简方案，核心思路是“按需取字”。我们不需要把整个汉字库都塞进ESP32，而是只生成并嵌入项目实际用到的那些汉字字模。这种方法不仅节省了宝贵的Flash空间，而且整个过程清晰、可控，从字库生成到代码显示，最快5分钟就能跑通。

这篇文章面向的是已经对MicroPython和ESP32基础开发有所了解，但被中文显示问题困扰的开发者。我们会从原理入手，手把手带你使用经典工具PCtoLCD2002制作自定义字库，并深入讲解如何在MicroPython中灵活地解析和显示这些字模数据。你会发现，让OLED说“中文”，其实一点也不难。

1. 理解核心原理：点阵字模与MicroPython的图形缓冲

在开始动手之前，我们有必要花几分钟搞清楚OLED显示中文的本质。这能帮助你在后续遇到问题时，知道从哪里着手排查。

SSD1306这类OLED屏幕本身并不“认识”任何字符，无论是英文还是中文。它只认识“点”——每个像素点是亮（1）还是灭（0）。我们要做的，就是把汉字“画”到这块由128x64个点构成的“画布”上。那么，汉字如何变成“点”的集合呢？答案就是字模。

一个汉字，比如“中”字，在计算机里通常用UTF-8编码表示，这是字符的“身份证号”。但屏幕需要的是它的“肖像画”——即用二进制0和1描绘出的点阵图形。对于常见的16x16像素的汉字，这个“肖像画”就是由32个字节（16行 x 16列 / 8位每字节）的数据构成的。每个字节的8个比特，控制着水平方向上连续的8个像素点的明暗。

在MicroPython中，我们通过 framebuf 模块来操作这块“画布”。SSD1306_I2C 驱动类内部就包含一个 FrameBuffer 对象。我们熟悉的 oled.text() 函数，其实只内置了西方字符（ASCII）的字模。当它遇到中文字符的UTF-8编码时，根本无法识别，因此要么忽略，要么显示为乱码。

所以，我们的技术路径非常明确：

提取目标汉字：确定你的项目需要显示哪些汉字。
生成字模数据：将这些汉字转换为对应的点阵字节数组。
存储与调用：将这些字节数组以合适的数据结构（如字典）存储在代码中。
自定义显示函数：编写一个函数，将字模数据“画”到 FrameBuffer 的指定位置。

提示：为什么选择16x16字体？这是在小尺寸OLED（如0.96寸）上显示中文的清晰度与空间占用的最佳平衡点。12x12可能不够清晰，24x24则会占用太多屏幕空间。

理解了这些，我们就知道，整个流程的关键在于第二步——如何高效、准确地将汉字转化为字模数据。接下来，我们就请出一位经典的工具助手。

2. 字库生成实战：使用PCtoLCD2002制作精准字模

工欲善其事，必先利其器。PCtoLCD2002 是一款非常经典且免费的汉字字模提取软件，虽然界面复古，但功能强大且稳定。下面我们一步步来配置它，生成我们需要的字模数据。

首先，你需要获取这个软件。它很容易在各大开发者社区或硬件论坛找到。下载并解压后，直接运行 PCtoLCD2002.exe。如果你的系统语言环境非中文，软件界面可能会出现乱码。一个简单的解决方法是，右键点击可执行文件，在“属性”的“兼容性”选项卡中，勾选“以简体中文模式运行此程序”（Windows系统）。

软件启动后，按以下步骤进行配置，这是保证生成字模能与MicroPython完美配合的关键：

模式设置：点击菜单栏的“模式”，确保选中“字符模式”。
选项配置：点击“选项”，弹出设置窗口，进行如下关键设置：
- 字模选项：
  - 点阵格式：选择阴码（即亮点为1，灭点为0，这是最常用的格式）。
  - 取模方式：选择 逐列式（也叫列行式，先垂直方向取数据）。对于SSD1306，这是标准方式。
  - 取模走向：选择顺向（即字节内高位在前，低位在后）。
  - 输出数制：选择 十六进制。