Arduino TFT彩屏驱动与交互开发全攻略：从硬件选型到实战项目

1. 项目概述：为什么Arduino玩家需要一块TFT彩屏？

如果你玩Arduino有一段时间了，点亮过LED，驱动过舵机，也通过串口监视器看过数据，那你可能会开始觉得，那个黑白的、只能显示文本的串口窗口有点“不够看”了。数据是冰冷的数字，而视觉是直观的体验。这时候，一块TFT彩屏就能彻底改变你的项目交互方式。它不再是一个简单的调试工具，而是一个能够显示丰富图形、绘制实时曲线、甚至构建简易用户界面的窗口。

TFT（Thin Film Transistor，薄膜晶体管）液晶屏，本质上是一种主动矩阵式的LCD。和我们手机、电脑屏幕的原理类似，每个像素点都由一个独立的晶体管控制，这让它具备了响应速度快、色彩鲜艳、对比度高的优点。对于Arduino这样的微控制器来说，驱动一块分辨率适中（比如240x320像素）的TFT彩屏，就像是为它装上了一双“眼睛”和一个“嘴巴”，既能感知信息（如果带触摸功能），又能生动地表达信息。

我最初接触TFT彩屏是为了做一个环境监测站。当时用传感器采集温湿度、气压数据，如果只在串口里看，不仅枯燥，而且无法直观感受变化趋势。当我成功让这些数据以数字和曲线图的形式在彩屏上实时刷新时，那种成就感远超点亮一个LED。无论是制作一个带界面的智能小车遥控器、一个显示频谱的音乐播放器，还是一个迷你游戏机，TFT彩屏都能让你的创意立刻变得“可视化”和“可交互”。接下来，我就结合自己踩过的坑和积累的经验，带你从零开始，玩转Arduino与TFT彩屏。

2. 核心硬件选型与连接：找到适合你的那块屏

市面上Arduino可用的TFT彩屏模块种类繁多，选对型号是成功的第一步。不同的驱动芯片、接口和分辨率，直接决定了你的代码复杂度和项目性能。

2.1 常见TFT屏模块类型与驱动芯片解析

对于Arduino爱好者，最常见且友好的TFT屏主要基于以下几种驱动芯片，它们各有特点：

1. ILI9341：这是绝对的“明星”型号，性价比之王。它支持240x320（QVGA）分辨率，262K色，接口丰富。围绕它的社区资源、库函数和示例代码是最多的，几乎你遇到的任何问题都能在网上找到答案。如果你第一次用TFT屏，无脑选ILI9341基本不会错。

2. ST7735：常见于较小的屏幕，如1.8寸128x160分辨率。它比ILI9341更省电，驱动也相对简单，适合对尺寸和功耗有要求的小项目，比如可穿戴设备。

3. ILI9488：可以看作是ILI9341的“大哥”，通常支持更高的分辨率，如320x480。它对Arduino UNO这类8位MCU的压力较大，刷新全屏会慢一些，更适合用ESP32、STM32等性能更强的板子驱动。

注意：购买时一定要确认模块的驱动芯片型号。商家可能只标“2.4寸TFT彩屏”，但驱动芯片可能是ILI9341、HX8347或其他。型号不对，库就无法驱动，这是新手最容易踩的坑。购买链接或商品详情页里一定会写。

2.2 通信接口选择：SPI vs 8位并行

TFT屏与Arduino通信主要有两种方式，这决定了你需要占用多少IO口以及刷新速度。

1. SPI接口：这是最推荐新手使用的方式。它只需要4-5根数据线（MOSI, MISO, SCK, CS, DC），有时再加一根复位线RST和背光线LED。优点是接线简单，占用IO口少，库支持完善。缺点是刷新速度相对并行接口慢，但对于显示数据、更新UI来说完全够用。市面上绝大多数为Arduino优化的TFT模块都默认采用SPI接口。

2. 8位并行接口：需要8根数据线（D0-D7）外加5根控制线（CS, DC, WR, RD, RST）。优点是刷新速度快，适合需要高速刷屏的应用（比如播放动画）。缺点是接线复杂，几乎用光了Arduino UNO的所有数字IO口，导致你很难再连接其他传感器。除非项目对帧率有极高要求，否则不建议新手从并行接口入手。

我的选择建议：对于Arduino UNO/Nano这类板子，优先选择SPI接口的ILI9341驱动2.4寸屏。这是一个经过无数项目验证的“黄金组合”，平衡了性能、易用性和资源占用。

2.3 硬件连接实战（以SPI ILI9341为例）

我们以最常见的Arduino UNO和SPI接口的2.4寸ILI9341屏为例进行连接。模块引脚通常标有丝印。

Arduino UNO 引脚	TFT模块引脚	作用
5V	VCC	电源正极
GND	GND	电源地
D13 (SCK)	SCK	SPI时钟线
D11 (MOSI)	SDI (MOSI)	SPI数据输出（主设备出，从设备入）
D10	CS (TFT_CS)	片选，低电平选中屏幕
D9	DC (RS/A0)	数据/命令选择，高电平写数据，低电平写命令
D8	RST	复位（可选，也可接VCC，用软件复位）
3.3V 或 D7	LED	背光控制（接3.3V常亮，或接IO口用PWM调光）

实操心得：

1. 背光处理：模块的LED脚最好通过一个220Ω的限流电阻连接到3.3V或一个IO口。直接接5V可能会使背光过亮、发热甚至烧毁。用IO口控制可以方便地实现息屏省电。
2. 电源隔离：如果屏幕在运行时出现花屏、乱码或复位，很可能是电源问题。Arduino UNO的5V输出带载能力有限。建议给屏幕的VCC单独供电，或者使用一个外部5V电源，并与Arduino共地。
3. 接线顺序：建议先接电源（VCC, GND）和背光，确保屏幕能亮。再接SPI总线（SCK, MOSI），最后接控制线（CS, DC, RST）。这样便于分段调试。

3. 软件库配置与基础图形编程

硬件连接好后，软件才是让屏幕“活”起来的关键。我们将使用社区最强大的Adafruit_GFX图形核心库和针对特定驱动芯片的库（如Adafruit_ILI9341）。

3.1 库的安装与初始化

首先，打开Arduino IDE，依次点击工具 -> 管理库...，在库管理器中搜索Adafruit ILI9341。找到后安装，它会自动关联安装依赖的Adafruit GFX Library和Adafruit BusIO库。这是最稳妥的方式。

安装完成后，你可以通过文件 -> 示例 -> Adafruit ILI9341 -> graphicstest来运行一个综合测试程序。但在此之前，我们需要根据你的实际接线修改初始化代码。

打开一个空白工程，写入以下基础代码框架：

#include <SPI.h> #include <Adafruit_GFX.h> #include <Adafruit_ILI9341.h> // 根据你的接线定义引脚 #define TFT_CS 10 #define TFT_DC 9 #define TFT_RST 8 // 如果接在VCC，这里写 -1 // 创建屏幕对象，参数为：片选、数据/命令、复位引脚 Adafruit_ILI9341 tft = Adafruit_ILI9341(TFT_CS, TFT_DC, TFT_RST); void setup() { Serial.begin(115200); Serial.println("ILI9341 Test!"); // 初始化屏幕 tft.begin(); // 设置屏幕旋转方向（0-3），根据你的模块安装方向调整 tft.setRotation(1); // 通常1或3是横屏模式 // 用黑色清屏 tft.fillScreen(ILI9341_BLACK); } void loop() { // 主循环 }

上传这段代码，如果屏幕成功清屏为黑色，恭喜你，硬件连接和基础库驱动成功了！

3.2 核心绘图函数详解与使用技巧

Adafruit_GFX库提供了丰富的绘图函数，理解它们的使用逻辑比死记硬背更重要。

1. 坐标系统：原点(0,0)默认在屏幕的左上角。X轴向右递增，Y轴向下递增。setRotation()函数会改变这个方向。在绘图前，务必明确你当前的旋转设置。

2. 绘制基本图形：

// 画点 tft.drawPixel(x, y, color); // 画线 (起点x, 起点y, 终点x, 终点y, 颜色) tft.drawLine(10, 10, 100, 50, ILI9341_RED); // 画矩形 (左上角x, 左上角y, 宽, 高, 颜色) tft.drawRect(20, 20, 80, 60, ILI9341_GREEN); // 空心矩形 tft.fillRect(20, 20, 80, 60, ILI9341_BLUE); // 实心矩形 // 画圆 (圆心x, 圆心y, 半径, 颜色) tft.drawCircle(120, 120, 30, ILI9341_YELLOW); tft.fillCircle(120, 120, 30, ILI9341_CYAN); // 画三角形 (三个顶点的x,y坐标, 颜色) tft.drawTriangle(200, 20, 180, 80, 220, 80, ILI9341_MAGENTA);

3. 显示文本：显示文本是UI的基础，但也是最容易出问题的地方。

// 1. 设置文本颜色和背景色（背景色可选，透明背景用 ILI9341_BLACK） tft.setTextColor(ILI9341_WHITE, ILI9341_BLACK); // 白字黑底 // 2. 设置文本大小（1是默认5x7像素字体，2是10x14，以此类推） tft.setTextSize(2); // 3. 设置光标位置（文本的左上角起始点） tft.setCursor(10, 50); // 4. 打印内容 tft.print("Hello, TFT!"); // 也可以直接打印变量 int sensorValue = 123; tft.setCursor(10, 80); tft.print("Value: "); tft.print(sensorValue);

注意事项：

• 字体与内存：默认字体是内置的位图字体，放大后会有锯齿。库也支持加载自定义字体，但会消耗大量宝贵的Arduino SRAM和Flash空间，在UNO上需谨慎使用。
• 清屏与局部更新：fillScreen()会清空整个屏幕，耗时较长（几十到上百毫秒）。如果只是更新部分数据（如传感器读数），最好只重绘变化的区域，而不是全屏刷新。例如，在更新数字前，先用背景色画一个实心矩形覆盖旧数字区域，再写新数字。
• 颜色格式：颜色是16位的RGB565格式（高5位红，中6位绿，低5位蓝）。库提供了常用颜色的宏定义（如ILI9341_RED），你也可以用tft.color565(255, 0, 0)来生成自定义颜色。

4. 实战项目一：构建实时传感器数据仪表盘

现在，我们综合运用以上知识，创建一个能实时显示多路传感器数据的仪表盘。假设我们连接了一个DHT11温湿度传感器和一个模拟光敏电阻。

4.1 硬件扩展与电路设计

• DHT11：数据线接Arduino D2引脚。
• 光敏电阻：与一个10kΩ电阻组成分压电路，中间点接模拟引脚A0。
• TFT屏：按前述SPI方式连接。

电路连接要点：确保所有器件共地。模拟传感器尽量使用稳定的参考电压。如果屏幕干扰传感器读数（常见于模拟信号），可以尝试在传感器电源处加一个10uF-100uF的电容滤波。

4.2 软件代码实现与优化

我们需要安装DHT sensor library库。代码思路是：在setup()中初始化并绘制静态UI框架（标题、标签、单位等），在loop()中周期性地读取传感器数据并更新显示区域。

#include <SPI.h> #include <Adafruit_GFX.h> #include <Adafruit_ILI9341.h> #include <DHT.h> #define TFT_CS 10 #define TFT_DC 9 Adafruit_ILI9341 tft = Adafruit_ILI9341(TFT_CS, TFT_DC); #define DHTPIN 2 #define DHTTYPE DHT11 DHT dht(DHTPIN, DHTTYPE); #define LIGHT_SENSOR_PIN A0 // 定义数据显示区域的位置和大小，方便局部刷新 #define TEMP_X 80 #define TEMP_Y 60 #define HUMI_X 80 #define HUMI_Y 100 #define LIGHT_X 80 #define LIGHT_Y 140 #define BOX_WIDTH 100 #define BOX_HEIGHT 30 void setup() { Serial.begin(115200); dht.begin(); tft.begin(); tft.setRotation(1); tft.fillScreen(ILI9341_BLACK); // 绘制静态界面框架 tft.setTextSize(2); tft.setTextColor(ILI9341_WHITE); tft.setCursor(20, 20); tft.print("Sensor Dashboard"); tft.setTextColor(ILI9341_CYAN); tft.setCursor(20, TEMP_Y); tft.print("Temp:"); tft.setCursor(20, HUMI_Y); tft.print("Humi:"); tft.setCursor(20, LIGHT_Y); tft.print("Light:"); // 为动态数据区域预先画一个背景框（可选，美观） tft.fillRect(TEMP_X, TEMP_Y, BOX_WIDTH, BOX_HEIGHT, ILI9341_BLACK); tft.fillRect(HUMI_X, HUMI_Y, BOX_WIDTH, BOX_HEIGHT, ILI9341_BLACK); tft.fillRect(LIGHT_X, LIGHT_Y, BOX_WIDTH, BOX_HEIGHT, ILI9341_BLACK); } void loop() { float h = dht.readHumidity(); float t = dht.readTemperature(); int lightValue = analogRead(LIGHT_SENSOR_PIN); // 更新温度显示（局部刷新） tft.fillRect(TEMP_X, TEMP_Y, BOX_WIDTH, BOX_HEIGHT, ILI9341_BLACK); tft.setTextColor(ILI9341_YELLOW); tft.setTextSize(2); tft.setCursor(TEMP_X, TEMP_Y); if (isnan(t)) { tft.print("Error"); } else { tft.print(t, 1); // 显示一位小数 tft.print(" C"); } // 更新湿度显示 tft.fillRect(HUMI_X, HUMI_Y, BOX_WIDTH, BOX_HEIGHT, ILI9341_BLACK); tft.setCursor(HUMI_X, HUMI_Y); if (isnan(h)) { tft.print("Error"); } else { tft.print(h, 0); // 显示整数 tft.print(" %"); } // 更新光照显示（映射到百分比） tft.fillRect(LIGHT_X, LIGHT_Y, BOX_WIDTH, BOX_HEIGHT, ILI9341_BLACK); tft.setCursor(LIGHT_X, LIGHT_Y); int lightPercent = map(lightValue, 0, 1023, 0, 100); tft.print(lightPercent); tft.print(" %"); // 添加一个简单的进度条表示光照强度（视觉化） int barLength = map(lightValue, 0, 1023, 0, 200); tft.drawRect(20, 180, 204, 20, ILI9341_WHITE); // 进度条边框 tft.fillRect(22, 182, barLength, 16, ILI9341_GREEN); // 填充部分 delay(2000); // 每2秒更新一次，避免DHT11读取过于频繁 }

代码优化解析：

• 局部刷新：我们没有使用fillScreen()，而是用fillRect()在更新每个数据前，先用背景色清除之前数字所在的矩形区域。这比全屏刷新快得多，也避免了屏幕闪烁。
• 错误处理：读取DHT11可能失败，用isnan()判断并显示“Error”，提高了程序的健壮性。
• 视觉化增强：将枯燥的光照数值映射成一个进度条，让数据变化更直观。这是提升项目观感的一个小技巧。

5. 实战项目二：实现简易触摸屏交互（以XPT2046为例）

很多TFT彩屏模块会集成电阻式触摸控制器，最常见的是XPT2046。这让你可以制作真正的交互式项目，比如按钮、滑块、键盘。

5.1 触摸屏原理与接线

电阻触摸屏相当于一个模拟电位器，通过XPT2046芯片将触摸点的压力转化为SPI接口的数字信号。接线通常与TFT屏共用SPI总线（SCK, MOSI, MISO），但使用独立的片选（T_CS）和中断（IRQ）引脚。

Arduino UNO 引脚	XPT2046 触摸模块引脚
3.3V 或 5V	VCC
GND	GND
D13 (SCK)	SCK
D12 (MISO)	DOUT (MISO)
D11 (MOSI)	DIN (MOSI)
D7	T_CS (或CS)
D6	IRQ (可选)

注意：XPT2046的工作电压通常是2.2V-5.25V，但它的IO口电平需要与MCU匹配。如果Arduino是5V逻辑，而模块是3.3V逻辑，需要在数据线上加电平转换电路，否则可能损坏触摸芯片。购买时最好选择标有“5V兼容”或自带电平转换的模块。

5.2 触摸库的使用与坐标校准

我们需要一个触摸库。Adafruit_TouchScreen库是通用选择，但针对XPT2046，我更喜欢使用专一性更好的XPT2046_Touchscreen库（由Paul Stoffregen开发），它更高效。

安装库后，关键步骤是坐标校准。触摸屏返回的原始坐标值（通常0-4095）与屏幕像素坐标（如240x320）并不直接对应，且可能存在旋转和偏移。

校准程序思路：

1. 在屏幕四个角或特定位置显示校准点。
2. 提示用户依次点击这些点。
3. 记录每个点被触摸时的原始坐标。
4. 通过映射公式（通常是线性插值）计算出原始坐标到像素坐标的转换系数。

网上有很多现成的校准例程。一个简单有效的办法是：在setup()里，先读取几次触摸原始值，求出平均值，然后与你已知的屏幕旋转方向进行手动映射测试。例如，如果你的屏幕是setRotation(1)，那么触摸的X轴可能对应屏幕的Y轴。你需要写一小段测试代码，在触摸时同时打印原始坐标和在屏幕上画点，来观察对应关系，并调整映射公式。

5.3 创建交互按钮：从检测到反馈

实现一个按钮需要三步：检测触摸区域、判断按下/释放、提供视觉反馈。

#include <XPT2046_Touchscreen.h> #include <SPI.h> #define T_CS 7 // 触摸芯片片选 XPT2046_Touchscreen ts(T_CS); // 定义一个按钮结构 struct Button { int x, y, width, height; char* label; bool pressed; }; Button myBtn = {100, 200, 80, 40, "Click Me", false}; void setup() { Serial.begin(115200); ts.begin(); ts.setRotation(1); // 设置触摸方向，需与屏幕方向匹配 // ... 初始化屏幕tft ... drawButton(&myBtn); // 绘制初始按钮 } void loop() { if (ts.touched()) { // 如果有触摸 TS_Point p = ts.getPoint(); // 获取原始触摸点 // 将原始坐标p.x, p.y转换为屏幕像素坐标scrX, scrY（此处需使用你的校准公式） int scrX = ...; int scrY = ...; // 检查是否在按钮区域内 if (scrX > myBtn.x && scrX < (myBtn.x + myBtn.width) && scrY > myBtn.y && scrY < (myBtn.y + myBtn.height)) { if (!myBtn.pressed) { // 如果是新按下的 myBtn.pressed = true; drawButtonPressed(&myBtn); // 重绘为按下状态 Serial.println("Button Pressed!"); // 执行按钮对应的动作... } } } else { // 没有触摸时，如果按钮之前是按下的状态，则释放它 if (myBtn.pressed) { myBtn.pressed = false; drawButton(&myBtn); // 重绘为释放状态 } } delay(10); // 短暂延迟，降低CPU占用 } void drawButton(Button* btn) { tft.fillRoundRect(btn->x, btn->y, btn->width, btn->height, 5, ILI9341_BLUE); tft.drawRoundRect(btn->x, btn->y, btn->width, btn->height, 5, ILI9341_WHITE); tft.setTextColor(ILI9341_WHITE); tft.setTextSize(1); tft.setCursor(btn->x + 10, btn->y + 12); tft.print(btn->label); } void drawButtonPressed(Button* btn) { tft.fillRoundRect(btn->x, btn->y, btn->width, btn->height, 5, ILI9341_DARKBLUE); tft.drawRoundRect(btn->x, btn->y, btn->width, btn->height, 5, ILI9341_WHITE); tft.setTextColor(ILI9341_WHITE); tft.setTextSize(1); tft.setCursor(btn->x + 12, btn->y + 14); // 微调文字位置，模拟按下凹陷感 tft.print(btn->label); }

交互设计要点：

• 消抖与响应：触摸检测需要软件消抖。delay(10)和检查状态变化（!myBtn.pressed）可以防止一次触摸被误判为多次。
• 视觉反馈：按钮按下时改变颜色或位置，给用户明确的交互确认，这是良好用户体验的基础。
• 性能考虑：在loop()中持续检测触摸会占用CPU。如果项目复杂，可以考虑使用触摸芯片的中断引脚（IRQ），当有触摸时才唤醒MCU进行处理，更省电。

6. 高级技巧与性能优化

当你的项目内容变复杂时，可能会遇到屏幕刷新慢、内存不足等问题。这里分享几个进阶技巧。

6.1 使用帧缓冲（Frame Buffer）实现流畅动画

Arduino直接操作屏幕是“画一笔，传一笔”，频繁的SPI通信会成为瓶颈。帧缓冲的思路是在Arduino的内存（或外部SRAM）中开辟一块和屏幕分辨率对应的数组，所有绘图操作先在这个内存数组中进行，完成一整帧画面后，再一次性发送到屏幕。这能极大减少SPI通信开销，实现流畅动画。

但对于Arduino UNO（2KB SRAM）来说，一个240x320的16位色缓冲区需要2403202 = 153,600字节，远超其能力。因此，帧缓冲通常用于ESP32、STM32等拥有大量内存的MCU。例如，在ESP32上，你可以使用TFT_eSPI库，它内置了帧缓冲支持。

折中方案：对于UNO，我们可以实现“局部帧缓冲”。比如只对屏幕上频繁变化的一小块区域（如一个80x60的动画区域）使用内存缓冲，更新完后一次性写入屏幕。这需要你手动管理内存数组和tft.drawRGBBitmap()函数。

6.2 图片显示：从SD卡读取与解码

在TFT屏上显示图片能极大提升项目颜值。图片需要先转换为Arduino可用的格式。通常有两种方法：

1. 位图数组：使用工具（如LCD Image Converter）将图片转换为C语言数组，直接编译进程序。优点是读取快，缺点是占用大量程序存储空间（Flash），且修改图片需要重新编译上传。适合小图标、logo等固定资源。

2. 从SD卡读取：将图片（通常是BMP或经过压缩的格式）存放在SD卡中，运行时读取并解码显示。这需要额外的SD卡模块和文件系统库（如SD）。Adafruit_ImageReader库可以配合Adafruit_GFX来显示SD卡上的BMP图片。

操作流程：

• 接线：SD卡模块也使用SPI，需要与TFT屏共享总线，但使用独立的CS引脚。
• 格式：图片必须为24位或更低深度的BMP格式，并且需要调整大小以适应屏幕分辨率。
• 内存：解码图片需要缓冲区，UNO可能只能显示很小的图片。ESP32等平台会更适合。

6.3 降低功耗与屏幕维护

对于电池供电的项目，功耗是关键。

1. 背光控制：背光是最大的耗电源。将背光引脚（LED）连接到PWM引脚（如D3），用analogWrite()调节亮度，或在不需要显示时完全关闭。

   #define TFT_BL 3 analogWrite(TFT_BL, 128); // 50%亮度 analogWrite(TFT_BL, 0); // 关闭背光

2. 睡眠模式：一些高级驱动芯片支持睡眠指令。通过发送命令让屏幕进入低功耗睡眠模式，需要时再唤醒。具体命令需查阅芯片数据手册，通常可以在对应的库文件中找到相关函数或自己通过tft.sendCommand()发送。

3. 减少刷新：如前所述，使用局部刷新，避免不必要的fillScreen()。

4. 屏幕保护：长时间显示静态画面可能导致“烧屏”（残影）。可以编写一个简单的屏保程序，比如定时轻微移动显示内容，或定时切换黑白反色。

7. 常见问题排查与解决方案实录

这里汇总了我自己和社区里经常遇到的一些问题及解决办法。

问题现象	可能原因	排查步骤与解决方案
屏幕白屏或花屏	1. 电源功率不足。 2. 复位时序不对。 3. 接线错误或接触不良。 4. 驱动芯片型号与库不匹配。	1. 用万用表测量VCC电压，尝试外接独立5V电源。 2. 在setup()开头添加pinMode(TFT_RST, OUTPUT); digitalWrite(TFT_RST, LOW); delay(10); digitalWrite(TFT_RST, HIGH); delay(120);进行硬复位。 3. 逐根检查接线，尤其是SCK和MOSI是否接反。 4. 核对模块驱动芯片，尝试更换其他驱动库（如TFT_eSPI）。
触摸完全不准或没反应	1. 坐标未校准。 2. SPI冲突或接线错误。 3. 触摸芯片供电问题。 4. 库的旋转设置与屏幕不一致。	1. 运行校准程序，获取并应用校准参数。 2. 确保触摸CS引脚与代码中定义一致，MISO线已连接。 3. 检查触摸模块VCC电压，如果是3.3V模块接5V可能会损坏。 4. 确保ts.setRotation()与tft.setRotation()的值一致。
显示内容错位或镜像	屏幕旋转设置错误。	调整tft.setRotation()参数（0-3），分别尝试，找到正确的显示方向。
文字或图形显示不全	坐标计算超出屏幕范围。	在绘图前打印坐标值到串口调试，确保(x, y)和(width, height)在屏幕分辨率内。
刷新速度极慢	1. 使用了全屏刷新fillScreen()。 2. SPI时钟频率太低。 3. 代码中有不必要的延时。	1. 改用局部刷新。 2. 某些库（如TFT_eSPI）允许设置SPI频率，尝试提高。 3. 检查loop()中是否有长的delay()，用millis()进行非阻塞定时。
编译时报内存不足	1. 使用了过大字体或图片数组。 2. 全局变量过多。 3. 库文件占用大。	1. 减少或移除自定义字体/图片。 2. 将不常用的字符串放入Flash（用F()宏，如Serial.print(F(“Hello”))）。 3. 尝试使用更精简的库，或升级到内存更大的开发板（如Arduino Mega 2560）。
与SD卡等其他SPI设备冲突	多个SPI设备片选（CS）未管理好。	确保同一时间只有一个设备的CS引脚为低电平（选中）。操作完一个设备后，立即将其CS拉高，再操作下一个。

最后一点个人体会：玩转Arduino TFT彩屏，三分靠硬件，七分靠软件和调试。遇到问题，首先用最简化的测试程序（比如官方的graphicstest）排除硬件故障，然后逐步添加自己的功能。多利用串口打印调试信息，把变量的值、程序的执行流程打印出来，这是排查逻辑错误最有效的方法。这个从“点不亮”到“跑得欢”的过程，正是嵌入式开发最吸引人的地方。当你亲手让这块小小的屏幕展现出预想的画面时，所有的折腾都值了。