ESP32驱动0.96寸OLED屏幕：SSD1306接线与Arduino显示实战

1. 项目概述与整体思路

1.1 为什么给ESP32配一块OLED屏幕

调ESP32的板子，前期最痛苦的一件事就是“看不见”。串口打印虽然能用，但每次想看数据都得插着USB线，开着串口监视器，日志滚动起来眼睛跟不上。更别说做到一半想脱离电脑跑个独立小设备，状态显示全凭猜——LED灯闪几下，闪烁节奏还得自己去查代码才能回忆起来。这种时候，给ESP32配一块0.96寸的OLED显示屏，几乎是最低成本换来最大方便的做法。

这块屏体积只有指甲盖大小，却能把关键信息直接摆在眼前：传感器读数、IP地址、WiFi连接状态、按钮触发结果、程序运行到哪一步了，全部一目了然。调试的时候不用再开串口，做成品的时候还能当交互界面。0.96寸OLED模块市面上零售价也就十几块到二十几块，散件拿过来四根线就能接，对零基础选手非常友好。

这篇文章面向的读者是那种“刚拿到ESP32板子、还没写过几行代码、想做出第一个带屏幕的东西”的人。跟着步骤走，你可以在一两个小时之内点亮屏幕，然后在上面显示文字、数字、图形，再进阶到汉字、传感器数据、菜单切换这些实际玩法。我会把从硬件接线、开发环境、代码实现到常见坑点全部讲一遍，全是实际跑过之后沉淀下来的经验。

1.2 0.96寸OLED屏幕的核心规格

很多新手第一次看到OLED模块，容易把它跟LCD液晶屏搞混。其实两者的显示原理完全不同：OLED是自发光器件，每个像素点自己发光，所以它不需要背光，黑色区域是真正“全黑”的，对比度非常高。而LCD需要背光板，黑色其实是压暗的灰色。这一点直接决定了两者在功耗和观感上的差异——OLED模块正常显示时电流也就十几毫安到二十几毫安，工作电压3.3V就能跑，跟ESP32是绝配。

市面上最常见的0.96寸OLED模块，分辨率是128x64像素，意思是横向128个点、纵向64个点。控制芯片绝大多数是SSD1306，这是一个非常成熟的驱动IC，几乎所有主流库都对它有完善支持。模块上会引出四个引脚：VCC、GND、SCL、SDA，对应IIC通信接口。

有些模块还带有复位引脚RESET和命令/数据选择引脚DC，那是SPI版本才会用到的。买的时候认准“IIC接口”或“I2C”字样的版本，四根线就够用了。这块屏幕画一个字符，默认字号下大概是6x8像素，一屏满打满算能排21个英文字符乘8行，显示信息量不算大，但显示关键状态完全够用。

1.3 方案选型：IIC接口和SPI接口怎么选

OLED模块常见的通信接口有IIC和SPI两种。IIC只需要两根信号线（SCL时钟、SDA数据），加上电源和地总共四根线，接法简单，不容易错。缺点是传输速率相对慢一些，刷新率低，做动画会有肉眼可见的卡顿。SPI则需要五根以上的线（SCLK、MOSI、DC、CS、RESET），接线繁琐，还需要占用更多GPIO，但刷新速度快很多，适合做图形动画、波形绘制这类对刷新率要求高的场景。

对零基础入门来说，我的建议非常明确：选IIC版本。理由第一是接线少，四条线插上就能用，新手不容易接错；第二是示例代码多，搜索“ESP32 OLED”出来的教程十有八九都是IIC版本；第三是日常显示文字数字，IIC的刷新率完全够用，你不是拿它看电影。等你玩熟了，再考虑SPI版本追求更高刷新率也不迟。

这里还要提醒一个容易忽略的点：IIC和SPI版本的模块价格几乎一样，但引脚定义不同，买的时候一定看清商品标题里写的是“IIC接口”还是“SPI接口”，别等拿到手才发现针脚对不上。我的第一块OLED就是因为没仔细看，买成了SPI版本，结果多买了一根杜邦线不说，代码也得换成SPI模式的例程，凭空多绕了半小时。

2. 开发环境搭建与硬件接线

2.1 Arduino IDE安装ESP32支持包

驱动OLED这块屏幕，我推荐用Arduino IDE来写代码，主要原因是生态成熟、库丰富、社区例子多，而且对新手来说门槛最低。如果你完全从零开始，先到官网下载Arduino IDE，装好后打开“文件”菜单里的“首选项”，在“附加开发板管理器网址”一栏填入ESP32的官方JSON地址：

https://espressif.github.io/arduino-esp32/package_esp32_index.json

填完保存后，打开“工具”菜单，进入“开发板”下的“开发板管理器”，搜索“esp32”，找到“esp32 by Espressif Systems”，点击安装。这一步会下载一份不小的文件，耗时取决于网络情况，慢的时候可能要十几分钟。装完之后在“工具”菜单的“开发板”列表里就能看到ESP32系列的各种板型了，常用的比如“ESP32 Dev Module”“NodeMCU-32S”都可以选。

新手在这一步最容易遇到的问题，是安装过程中提示“Timeout”或者下载失败，网络环境不稳定的时候尤其常见。解决办法有两个方向：一是换个时间段重试，或者把网络从WiFi切换到手机热点，很多时候热点更稳定；二是用脚本下载离线安装包手动解压到Arduino的硬件目录里，虽然操作稍复杂，但一劳永逸。目前最新版的Arduino IDE在安装ESP32支持包时已经比旧版顺畅不少，大概率重试几次就能成功。

2.2 引脚接线与IIC通信原理

接线是整个项目里最简单但也最容易被忽视的一步。ESP32开发板上通常有多组IIC引脚可用，但默认最常用的是GPIO21作为SDA（数据线）、GPIO22作为SCL（时钟线）。如果你用的是常见的ESP32 DevKit开发板，直接在板子两侧排针上找到标注为“21”“22”的引脚，然后按下面对照表接线：

有些开发板会对SDA和SCL标注成D21、D22，注意对应的就是GPIO编号。接好后，上电时OLED屏幕会闪一下白屏，这是正常的，说明屏已经通电了。如果板上没有标注，也可以查你手里那块开发板的引脚图确认，不同厂家的丝印可能不一样，但GPIO编号是统一的。

IIC通信本身原理不复杂，打个比方：SCL是时钟线，负责打节拍，SDA是数据线，负责在节拍下一个个位地传数据。总线上可以挂多个设备，每个设备有独立的7位地址，主机发起通信时先发送要访问的设备地址，只有地址匹配的设备才会回应。SSD1306这颗驱动芯片在硬件上最常见的地址是0x3C，少数模块会做成0x3D，后面写代码的时候如果找不到设备，先把地址换成0x3D试试。

2.3 安装SSD1306驱动库

Arduino生态里驱动SSD1306最常见的是两套库：一套是Adafruit出品的“Adafruit SSD1306”配合“Adafruit GFX Library”使用，功能全面、绘图函数丰富，适合绝大多数场景；另一套是“U8g2”，对中文显示支持更好、内置字体多，适合需要显示汉字的项目。入门阶段建议先装Adafruit这套，因为它的API更接近Arduino的习惯，初学者理解起来不费劲。

在Arduino IDE的库管理器里（工具菜单或左侧边栏进入），搜索“Adafruit SSD1306”，找到后点击安装。安装过程中它会提示需要安装依赖库“Adafruit GFX Library”和“Adafruit BusIO”，选择安装所有依赖即可。同样，如果你后面想用U8g2，直接在库管理器里搜索“U8g2”安装，它是一个单体库，没有额外依赖。

装完库之后，建议先做一个最简单的IIC扫描测试，确认ESP32能发现屏幕。下面这段代码会扫描IIC总线上的所有设备地址，并把结果显示在串口监视器里：

#include <Wire.h> void setup() { Serial.begin(115200); Wire.begin(); // 默认使用GPIO21(SDA)和GPIO22(SCL) Serial.println("I2C Scanner"); } void loop() { byte error, address; int nDevices = 0; for (address = 1; address < 127; address++) { Wire.beginTransmission(address); error = Wire.endTransmission(); if (error == 0) { Serial.print("I2C device found at address 0x"); if (address < 16) Serial.print("0"); Serial.println(address, HEX); nDevices++; } } if (nDevices == 0) Serial.println("No I2C devices found"); delay(2000); }

打开串口监视器，波特率设为115200，如果能看到“I2C device found at address 0x3C”，说明硬件接线和IIC通信链路都正常，可以进入下一步写显示代码了。如果没扫描到设备，先别急着怀疑库，多半是接线问题：VCC和GND接反了吗？SCL和SDA是不是插反了？逐一排查。

3. 点亮屏幕：从基础代码到核心实现

3.1 第一个例程：显示固定的英文字符

在确认IIC扫描到设备之后，就可以跑第一个真正让屏幕显示内容的程序。Adafruit SSD1306库自带的示例代码可以直接用，打开“文件”菜单，进入“示例”，找到“Adafruit SSD1306”，选择“ssd1306_128x64_i2c”即可。示例代码里会有类似下面这一段核心初始化逻辑：

#include <Wire.h> #include <Adafruit_GFX.h> #include <Adafruit_SSD1306.h> #define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 #define OLED_RESET -1 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET); void setup() { if (!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { Serial.println(F("SSD1306 allocation failed")); for (;;); } display.clearDisplay(); display.setTextSize(2); display.setTextColor(SSD1306_WHITE); display.setCursor(0, 0); display.println("Hello OLED"); display.display(); } void loop() { }

这一段代码有几点值得逐行解释一下。OLED_RESET设置为-1，表示不使用复位引脚，因为IIC版本的模块通常不接RESET引脚，这个值告诉库我们靠软件初始化就行。display.begin(SSD1306_SWITCHCAPVCC, 0x3C)里面第一个参数是供电方式，0.96寸模块用默认的SSD1306_SWITCHCAPVCC即可，第二个参数0x3C就是前面扫描到的IIC设备地址。

显示文字的流程分两步：先调用clearDisplay()清空显存，然后通过setCursor、println等函数把内容“画”进内存缓冲区，最后必须调用display()才会真正把缓冲区内容刷到屏幕上。新手常犯的错就是写完println之后忘了调用display()，结果屏幕一直黑着，误以为是硬件坏了。记住这个流程：清屏、画内容、刷新，三步缺一不可。

3.2 用Adafruit GFX库绘制图形和变量数据

Adafruit GFX库提供了丰富的绘图函数，掌握这些基本函数之后，屏幕上想画什么基本都能实现。最常用的有这么几个：drawPixel(x, y, color)画点，drawLine(x0, y0, x1, y1, color)画线，drawRect(x, y, w, h, color)画矩形边框，fillRect画实心矩形，drawCircle画圆，drawTriangle画三角形。坐标原点在屏幕左上角，x轴向右增加，y轴向下增加。

对于显示动态数据，最核心的就是setCursor(x, y)配合println()的组合。比如你想实时显示温度和湿度，代码思路大概是这样的：

display.clearDisplay(); display.setTextSize(1); display.setCursor(0, 0); display.print("Temp: "); display.print(temperature); display.println(" C"); display.setCursor(0, 16); display.print("Humi: "); display.print(humidity); display.println(" %"); display.display();

有一点要注意：Adafruit GFX库在换行时会自动处理，但如果你在屏幕上反复刷新数字，数字长度变化时末尾可能会残留上一轮的字符。比如上一轮温度是25.60，这一轮变成9.80，那25.60里残留的“6”可能会残留在屏幕上。解决办法是在刷新动态数字之前，先用fillRect把这块区域擦掉，或者显示固定位数（比如用print(9.8, 1)强制保留一位小数）。这个细节看似不起眼，但实际做项目时几乎都会遇到。

另外值得说明的是，这块屏幕的显存是1KB（128x64像素，1位色深，128*64/8=1024字节），Adafruit库在初始化时会在ESP32的内存里分配这块缓冲区。ESP32有足够的内存，完全不用担心，但如果你用的是一块小内存的ATmega328P开发板，就要留意内存溢出问题，ESP32则完全不需要操心。

3.3 显示中文：取模与U8g2方案

英文字符显示简单，但实际项目中总要显示中文标题或提示信息，比如“温度”“湿度”“状态”。SSD1306内部没有中文字库，而Adafruit GFX库本身只内置了ASCII字体，所以直接显示中文是不行的。解决思路有两个：一是用取模软件把汉字变成位图数据，再通过drawBitmap画出来；二是换用U8g2库，它内置了多种中文字库，可以直接输出中文。

先说说取模方案。常用的取模软件有PCtoLCD2002、Img2Lcd等。操作步骤大致是：新建一个16x16像素的画布，输入你要显示的汉字，设置取模方式为“列行式”或“逐行式”，生成十六进制数组。然后把数组复制到代码里，调用display.drawBitmap(x, y, myBitmap, 16, 16, SSD1306_WHITE)就能显示出来。这个方法灵活，但每个字都要手动取模、手动放数组，十几个汉字下来很繁琐。

更推荐用U8g2库来显示中文。U8g2安装后，初始化方式略有不同，常用的是软件IIC模式：

#include <U8g2lib.h> #ifdef U8X8_HAVE_HW_SPI #include <SPI.h> #endif #ifdef U8X8_HAVE_HW_I2C #include <Wire.h> #endif U8G2_SSD1306_128X64_NONAME_1_4W_HW_I2C u8g2(U8G2_R0, /* clock=*/ SCL, /* data=*/ SDA, /* reset=*/ U8X8_PIN_NONE); void setup() { u8g2.begin(); u8g2.enableUTF8Print(); } void loop() { u8g2.firstPage(); do { u8g2.setFont(u8g2_font_wqy12_t_gb2312); u8g2.setCursor(0, 20); u8g2.print("温度: 25.6 C"); } while (u8g2.nextPage()); delay(1000); }

这里核心是u8g2_font_wqy12_t_gb2312这个字体，它内置了GB2312编码的中文字库，enableUTF8Print()启用后，u8g2.print("温度")就能直接输出中文。U8g2的刷新机制是firstPage()加nextPage()的页面循环，头一次接触会觉得写法别扭，实际上就是把要绘制的内容放在循环体里，库会自动处理分页缓冲。用习惯之后，其实比Adafruit库还顺手，尤其适合中文项目。

4. 进阶玩法：让OLED真正实用起来

4.1 做一个带菜单的交互界面

很多实际项目不希望屏幕一直固定显示一个画面，而是希望通过按键切换不同的页面。这一步做出来后，屏幕上显示什么就完全由代码逻辑决定了，项目的交互性一下子提升不少。思路也很简单：用GPIO接一个到两个按钮，读按钮状态，修改一个全局变量pageIndex，然后在loop里根据pageIndex的值来决定显示哪一页。

举个例子，定义一个状态变量，0表示首页、1表示传感器页、2表示设置页。每次按键，pageIndex加一，超过最大值就归零。显示部分写成一个renderPage()函数，内部用switch判断当前页并调用各自的绘制函数：

int pageIndex = 0; const int buttonPin = 0; void renderPage() { display.clearDisplay(); switch (pageIndex) { case 0: drawHomePage(); break; case 1: drawSensorPage(); break; case 2: drawInfoPage(); break; } display.display(); }

按钮扫描要注意消抖。最简单的方法是在检测到按下之后delay(50)再读一次，确认还是按下状态才执行切换逻辑。更专业的做法是用时间戳判断两次有效触发之间的间隔，避免一次按压因为抖动导致页面连跳好几页。我自己的习惯是：记录上一次按键处理的时间，间隔小于200毫秒的直接忽略，效果非常稳定。

如果你还想让用户体验更好，可以在页面顶部画一个进度条或者用反色高亮当前选中项，比如用fillRect把当前选项的背景填充为白色、文字改为黑色，就实现了“选中高亮”的效果。这些看起来很小的事情，做完之后的成就感非常强。

4.2 显示传感器数据：结合温湿度项目的完整示例

OLED最常见的实际用途之一就是当仪表盘显示传感器数据。这里用DHT11温湿度传感器作为例子，完整演示“读传感器—处理数据—显示到OLED”的全流程。DHT11是一款很便宜的数字温湿度传感器，单总线通信，一个GPIO就能读数据。

接线方面，DHT11的DATA引脚接到ESP32的GPIO4，VCC接3V3，GND接GND。代码里使用DHT库，在库管理器搜索“DHT sensor library”安装，同时它会依赖Adafruit Unified Sensor库，一并安装。核心代码如下：

#include <DHT.h> #include <Adafruit_SSD1306.h> #define DHTPIN 4 #define DHTTYPE DHT11 DHT dht(DHTPIN, DHTTYPE); Adafruit_SSD1306 display(128, 64, &Wire, -1); void setup() { dht.begin(); display.begin(SSD1306_SWITCHCAPVCC, 0x3C); display.clearDisplay(); display.setTextSize(2); } void loop() { float h = dht.readHumidity(); float t = dht.readTemperature(); display.clearDisplay(); display.setCursor(0, 0); display.print("Temp:"); display.setCursor(0, 20); display.print(t); display.print(" C"); display.setCursor(0, 40); display.print("Humi:"); display.setCursor(0, 60); display.print(h); display.print(" %"); display.display(); delay(2000); }

DHT11读取有个特点：每次读取间隔至少要1秒以上，否则会返回无效数据，所以loop里delay(2000)不仅是控制刷新率，更是保证传感器有足够的时间完成测量。如果你用的是DHT22或SHT30，读取间隔可以缩短，但DHT11的2秒刷新对OLED显示来说已经足够流畅。

如果你要做的是一个长期运行的温湿度监测设备，我强烈建议在屏幕上同时显示更新时间，并且把温度数据做一下简单的滤波处理，比如取最近十次读数的平均值。因为DHT11本身精度有限，读数波动有时达到±1度，直接显示原始值会让人怀疑设备坏了。

4.3 联网显示时间：NTP校时的OLED时钟

OLED显示时钟是很多人的入门练手项目，但单纯用ESP32内部的时间来计时，断电后就归零了，每次上电都要重新设置。更好的做法是让ESP32连上WiFi，通过NTP网络时间协议自动同步时间。这样只要设备联网，屏幕上显示的就是准确时间，不需要任何手动校准。

核心库是time.h，ESP32的Arduino核心已经内置了NTP相关支持。联网后调用configTime(gmtOffset_sec, daylightOffset_sec, "ntp.aliyun.com")配置NTP服务器，然后调用getLocalTime(&timeinfo)获取本地时间，再依次读取tm_hour、tm_min、tm_sec显示到屏幕上。

#include <WiFi.h> #include <time.h> const char* ssid = "yourSSID"; const char* password = "yourPASSWORD"; void setup() { WiFi.begin(ssid, password); while (WiFi.status() != WL_CONNECTED) { delay(500); } configTime(8 * 3600, 0, "ntp.aliyun.com"); } void loop() { struct tm timeinfo; if (getLocalTime(&timeinfo)) { display.clearDisplay(); display.setTextSize(2); display.setCursor(20, 10); char timeStr[10]; sprintf(timeStr, "%02d:%02d:%02d", timeinfo.tm_hour, timeinfo.tm_min, timeinfo.tm_sec); display.print(timeStr); display.setCursor(20, 40); char dateStr[20]; sprintf(dateStr, "%04d-%02d-%02d", timeinfo.tm_year + 1900, timeinfo.tm_mon + 1, timeinfo.tm_mday); display.print(dateStr); display.display(); } delay(1000); }

时区设置这里有个小坑：中国标准时间比UTC快8小时，所以configTime的第一个参数要传8 * 3600，也就是28800秒。如果你忽略了这一步，屏幕上的时间会慢8个小时。daylightOffset_sec设为0即可，因为我们没有夏令时的概念。另外注意tm_year是从1900年开始计算的，所以要加1900才是实际年份，tm_mon是从0开始的，所以要加1。

NTP时钟做好之后，加上前面讲过的传感器显示，就是一个相当完整的“桌面多功能信息屏”了，时间、温湿度一屏同时展示。再配一个3D打印外壳，放桌面上当摆件用，非常拿得出手。

5. 常见问题与排查技巧实录

5.1 “加了OLED函数就卡死”的三个真实原因

网上搜“oled 卡死”能找到一堆帖子，很多人写了好几行显示代码，一上电程序就跑不起来，或者跑着跑着卡死在某个地方。我排查过不少类似问题，绝大多数情况逃不过这三个原因。

第一个是IIC地址不匹配。程序里写死了0x3C，但你的模块实际地址是0x3D，begin()函数进去之后一直在等待设备应答，程序就“卡”在初始化那里。排查方法就是最开始说的IIC扫描程序，先把实际地址扫出来，再把代码里的地址改成扫描结果。这也提醒我们，begin()是有返回值的，写成if(!display.begin(...))的时候可以加上串口打印，快速定位问题。

第二个是初始化顺序的问题。有些新手会先创建Adafruit_SSD1306对象，然后在setup()里先跑WiFi连接、传感器读取，最后才初始化OLED。WiFi连接本身是个阻塞操作，如果连不上可能一直重试，屏幕自然一直没有反应，看起来就像“加了OLED卡死”。实际上不是OLED卡死的，是前面的代码把程序堵住了。建议的写法是先初始化OLED，显示一个启动画面，然后再去执行WiFi连接等耗时操作，这样至少屏幕上能看到状态提示。

第三个是内存分配失败。display.begin()内部需要为显存缓冲区分配内存，如果在这份代码里同时启用了太多功能，比如蓝牙、WiFi、SD卡等，都可能因为内存不足导致分配失败返回false，程序随后进入for(;;)死循环。解决办法是确保代码里不重复初始化相同功能的库，尤其是Wire库，不要同时被两个库分别初始化。

5.2 屏幕完全不亮或白屏的排查流程

遇到屏幕完全不亮，先别急着怀疑模块坏了，按顺序排查。第一步检查供电：拿万用表量一下OLED的VCC和GND之间的电压，正常应该在3.3V左右。如果只有零点几伏，大概率是接线松了或者接到了错误的引脚上。第二步检查信号线和数据线是否接反：SCL和SDA对调一下试试，这个错误的发生率非常高，因为很多新手只注意颜色对应，没注意引脚名称。

第三步再跑一次IIC扫描程序。如果扫描不到设备，但接线看起来没问题，尝试换一根杜邦线，或者把模块插到面包板的另一组孔位。杜邦线质量差也会导致信号不稳定，接触不良是很常见的事。如果IIC扫描到了设备但屏幕依然全黑，试着在初始化后加一行display.drawPixel(0, 0, SSD1306_WHITE); display.display();，看到左上角出现一个白点，说明驱动是正常的，只是你后面绘制的内容坐标或者设置有问题。

白屏还有一种可能是复位引脚的问题。虽然IIC版本不强制接RESET引脚，但个别模块的复位引脚悬空时电平不稳定，会导致芯片一直处于复位状态。这时候可以尝试在初始化代码前用普通GPIO手动拉一次低电平再拉高，也可以用杜邦线把RESET引脚接到ESP32的一个GPIO上，然后调用pinMode和digitalWrite手动控制复位时序，大多数情况能解决问题。

5.3 显示内容闪烁、残影的应对思路

OLED屏幕本身响应速度快，几乎不存在残影，如果你看到屏幕上内容有“鬼影”或者闪烁，问题基本出在刷新逻辑上。最常见的原因是刷新频率过低且没有做清屏处理：比如你更新半个屏幕的内容，而没有把不显示的部分清除干净，新旧内容叠加就会看起来像有残影。

我的建议是：如果你用Adafruit库，每次刷新前先clearDisplay()再重新绘制。虽然会多花一点时间，但对128x64的分辨率来说这点开销完全可以忽略。如果你觉得闪烁严重，还可以考虑使用U8g2库的页面缓冲模式（就是firstPage()和nextPage()），它内部会做双缓冲处理，显示效果比Adafruit库默认方式更稳。

另外还有一种进阶做法：不整屏刷新，只更新变化的部分。比如时钟的秒数变化，你可以在固定区域先fillRect擦掉旧数字，再绘制新数字，其余部分保持不变。这样不仅省电，而且局部刷新看起来更干净利落。OLED还有一个特性就是刷新越频繁越耗电，对电池供电的项目来说，减少整屏刷新次数能明显延长续航。

5.4 快速排查对照表

为了方便以后遇到问题能快速定位，我把常见症状和对应的解决方向整理成一张表，贴在这里方便查阅：

排查问题最忌讳的就是一次改多个变量。我的习惯是每次只改动一个地方，比如先换线再跑扫描、改完地址再看效果，这样出了问题能准确知道是哪一步引入的。折腾硬件本身就是学习的一部分，多踩几次坑之后，你对IIC、对OLED的理解会扎实很多。

最后再分享一个我个人的经验：拿到一块新的OLED模块，别急着往项目里塞，先单独用一块主板、一个扫描例程、一段显示例程把它跑通，确认模块本身没问题，再合并到项目里去。这样每一步的边界都很清晰，出了问题能迅速定位。很多人喜欢一次把传感器、屏幕、WiFi全部接好再写代码，结果一上电全乱套，根本不知道是哪个环节出了问题。有了这块小小的OLED显示屏，ESP32就像“长出了眼睛”，你写的每一行代码、采集到的每一个数据，都能实实在在地看见，这种正反馈对新手时期来说特别重要。