电压与电源陷阱

• 3.3V 与 5V 逻辑电平混用会损坏开发板 — ESP32 为 3.3V，Uno 为 5V，必须使用电平转换器（level shifter）
• USB 接口最大仅提供 500mA 电流 — 不足以驱动电机、舵机或大量 LED
• 切勿从 Arduino 的 5V 引脚直接为电机供电 — 应使用外部电源，并确保共地
• 欠压（brown-out）会导致随机复位 — 表现类似代码缺陷，实则为供电不足
• 在传感器电源引脚附近添加去耦电容（0.1µF）— 可显著降低噪声引发的异常行为

接线错误

• 悬空输入（floating inputs）会读取随机值 — 必须使用上拉或下拉电阻
• 所有元器件必须共用同一接地（common ground）— 独立接地将导致系统完全无法工作
• 长导线易引入噪声 — 模拟传感器连线应尽量短
• LED 必须串联限流电阻 — 直接连接会烧毁 LED 及 IO 引脚
• 反接极性会永久损坏元器件 — 上电前务必反复确认极性

引脚冲突

• RX/TX 引脚（0、1 号）与 Serial 功能冲突 — 使用串口监视器（Serial Monitor）时应避免将其用作普通 GPIO
• 部分引脚具备特殊功能 — 请查阅开发板引脚图（pinout），确认 I2C、SPI、支持中断的引脚等
• PWM 功能仅在标有波浪线（~）的引脚上可用 — 在非 PWM 引脚调用 analogWrite() 将无任何效果
• 芯片内置上拉电阻 — 使用 INPUT_PULLUP 模式可省去按钮所需的外部上拉电阻

时间控制陷阱

• delay() 会阻塞整个程序执行 — 此期间无法响应其他任务、读取输入或处理中断
• 使用 millis() 实现非阻塞定时 — 通过与上次操作时间比较来判断是否到期
• millis() 约每 50 天溢出一次 — 推荐采用减法判断： millis() - lastTime >= interval
• 对时间敏感的操作应使用中断 — attachInterrupt() 可实现毫秒级甚至更快速度的响应

内存限制

• Uno 仅有 2KB RAM — 过大的数组可能静默失败，并引发难以排查的异常行为
• 使用 F() 宏将字符串常量存储于 Flash — 如 Serial.println(F("text")) 可节省 RAM
• 使用 PROGMEM 存储常量数组 — 避免占用宝贵的 RAM 空间
• String 类会碎片化堆内存 — 为保证稳定性，推荐使用 char 数组替代

串口调试

• 串口波特率必须严格匹配 — 波特率不一致时显示乱码，而非明显报错
• Serial.begin() 必须在 setup() 中调用 — 此前的串口输出将被丢弃
• 串口打印会显著拖慢程序运行 — 发布版本中应移除或大幅减少此类调试输出

上传问题

• 开发板类型选择错误 — 可成功上传但程序无法正常运行
• 串口监视器（Serial Monitor）会独占串口 — 上传前请务必关闭
• USB 数据线可能仅为充电线 — 部分廉价线缆不支持数据传输
• Bootloader 损坏 — 可借助另一块 Arduino 作为 ISP 编程器重新烧录

传感器通信

• I2C 设备共享总线 — 应使用扫描程序（scanner sketch）检查地址冲突
• 5V 传感器接入 3.3V 开发板可能导致读数错误甚至硬件损坏 — 务必核对器件工作电压
• SPI 总线需为每个设备分配独立的片选（CS）引脚 — 不可共用片选信号线