ESP32-CAM烧录教程：Arduino IDE配置、接线与常见错误排查

最近总有朋友私信问我：手头有一块ESP32-CAM，接上电脑后板子上的红灯也亮了，但烧录时一直卡在Connecting，串口监视器一片空白，到底哪里没搞对？这类问题几乎占了我被问到的所有ESP32问题的一大半。其实多数情况下不是板子坏了，而是下载模式没触发、串口接线交叉错了，或者Arduino IDE里某一项配置漏了。这篇保姆级教程就把整个流程从头到尾捋一遍：用Arduino IDE从零配置ESP32-CAM，把它变成能在浏览器里直接看画面的网络摄像头，顺便把新人最容易踩的坑挨个点名。

如果一切顺利，这个过程熟练了确实5分钟能走完；但如果你是第一次接触ESP32，我建议预留半小时，边看边操作。这块板子让人又爱又恨的地方在于：性价比确实高，几十块钱就买到带WiFi、带摄像头、能扩展的完整开发板；但它没有板载USB口，必须用USB转TTL模块烧录，烧录前还得短接IO0，这对纯新手来说是一道不小的门槛。这篇文章就是冲着这道门槛来的，适合零基础小白，也适合买了板子一直吃灰、想重新捡起来的人。

1. 开始之前：ESP32-CAM能干什么，以及为什么选Arduino IDE

1.1 板载硬件一览

ESP32-CAM不是Arduino官方出的板子，本质上是基于ESP32-S模组的摄像头开发板。我手头这块是市面上最常见的AI Thinker版本，板上集成了这些东西：

• 一颗ESP32-S双核处理器，主频240MHz，带2.4G WiFi和蓝牙；
• 一个OV2640摄像头，200万像素，最高支持1600x1200分辨率；
• 一个Micro SD卡槽，可以存照片和视频帧；
• 一个红色电源指示灯和一个白色闪光灯LED；
• 一个复位按键，以及PIR人体红外传感器的排针接口。

OV2640的分辨率虽然不算高，但用来做家用监控、看宠物、看3D打印机、做延时摄影完全够用。有的卖家用OV5640（500万像素），价格稍贵，入门阶段区别不大，选OV2640版本性价比最高。

1.2 为什么选Arduino IDE，而不是ESP-IDF或MicroPython

ESP32-CAM可以用的开发方式不止一种：官方ESP-IDF、PlatformIO、MicroPython、Arduino IDE。给新手的建议，我永远先说Arduino IDE，原因很简单：生态成熟、示例代码多、资料好找。Arduino IDE里甚至自带了CameraWebServer这个官方示例，改一下WiFi账号密码就能跑出一个完整的浏览器摄像头页面。

有人可能会说ESP-IDF性能更好，确实，但光是把编译环境搭起来就能劝退一半人，更别提还得自己配摄像头驱动。PlatformIO也不错，但基于VS Code，对刚入门的朋友来说多了一层学习成本。Arduino IDE虽然界面朴素，但胜在直接：装IDE、加开发板包、选端口、点上传，四步走完。

1.3 这个项目的最终形态

走完这篇教程，你会得到这么个东西：ESP32-CAM通电后自动连接家里的2.4G WiFi，然后启动一个Web服务。你在电脑或手机浏览器里输入一串IP地址，就能看到实时画面，还能在网页上切换分辨率、调节画质、手动抓拍。

后续如果愿意折腾，还可以在此基础上做定时拍照存TF卡、接PIR传感器做抓拍告警、加舵机做云台摄像头。但这些都建立在一个前提上——先把基础流程跑通。这篇教程做的就是这件事。

2. 硬件准备与接线：这一步做错，后面全是坑

2.1 需要准备的硬件清单

开工前把东西备齐，我用的这套配置，全部加起来几十块：

• ESP32-CAM开发板：AI Thinker版本，板载OV2640摄像头；
• USB转TTL模块：常见的CH340G或CP2102芯片都行，主要用于给板子供电和烧录程序；
• 杜邦线：母对母，4根起，建议多备几根；
• Micro USB数据线：注意必须是能传数据的那种，有些便宜线只能充电，会导致烧录时电脑识别不到串口；
• 电脑上装好Arduino IDE，这个后面细说。

2.2 串口模块怎么接：一句话版本和原理版本

接线这件事，真有一半新人的问题出在这。先给一句话口诀：

ESP32-CAM的UOR接USB转TTL的TXD，UOT接USB转TTL的RXD，GND接GND，5V接VCC。

再看接线表：

这里有个特别容易绕晕的点：UOR全称是UART0 RX，也就是第0号串口的接收脚；UOT是UART0 TX，串口的发送脚。所以接串口模块时必须交叉：模块的TXD接UOR，模块的RXD接UOT。如果你两边T接T、R接R，数据链路就断了，烧录时会一直卡在Connecting。

原理其实很好理解：UART是点对点的串行通信，A设备的发送脚必须接到B设备的接收脚。这就跟两个人讲话一样，你的嘴得对着对方的耳朵，而不是嘴对嘴。串口通信以后也是排查问题的主要入口，跑起来的日志都是靠它输出，所以这一步值得多花两分钟确认。

2.3 供电问题：为什么推荐5V而不是3.3V

ESP32-CAM板子上有一颗AMS1117稳压芯片，官方默认供电是5V，板载稳压后再给ESP32芯片和摄像头供电。理论上用USB转TTL模块的3.3V输出也能让板子工作，但实际用起来你会发现，一旦摄像头打开对焦，或者WiFi发射瞬间电流需求变大，3.3V很容易被拉低，板子直接重启。现象就是画面出来一下又黑屏，或者串口日志里频繁出现reboot。

所以我的建议是：只要USB转TTL模块支持5V输出，就用5V。多数CH340/CP2102模块上有个跳线帽或开关，可以在3.3V和5V之间切换，接线前调一下。如果手上只有3.3V输出的模块，烧录时可以凑合用，但跑网络摄像头时最好单独给板子供5V电。

关键经验：如果你发现摄像头画面经常花屏、重启、WiFi连不上，先别急着怀疑程序，从电源查起，八成是供电不足，而不是代码问题。

2.4 摄像头软排线：第一道容易被忽略的坑

ESP32-CAM板子出厂时，OV2640摄像头和主板之间有一条软排线连接。很多卖家发货时会重新插一遍，但偶尔存在没插到位的情况。

检查方法很简单：看摄像头模组和主板之间是否贴紧，排线有没有歪斜。如果排线没插好，最常见的现象是烧录成功后，浏览器打开画面全黑或者满屏雪花。这时候你多半会以为是代码问题，其实是物理连接没到位。

插排线时要注意：金属触点朝下插入摄像头插座，然后扣紧黑色卡扣。不要反复插拔，排线触点很薄，刮花了就得换摄像头模组了。

2.5 IO0和GND短接：烧录ESP32-CAM和烧录普通板子最大的区别

这是ESP32-CAM和普通ESP32开发板操作上最大的区别。普通板子有USB口，插上就能烧；ESP32-CAM没有USB口，默认上电是从Flash启动，你要烧录程序，必须让芯片进入下载模式。

方法就是：拿一根杜邦线，把板子上的IO0引脚和GND短接，然后再给板子上电。IO0引脚在板子边缘，丝印标着IO0，GND周围有好几个，随便选一个。短接后再用Arduino IDE点上传，芯片启动时会检测到IO0被拉低，从而进入Bootloader下载模式。

时序上有个细节：如果板子已经上电了，你才把IO0和GND短接，那还不够。短接后需要按一下板子上的RST复位键，让芯片重新上电并检测IO0状态。完整的操作顺序建议这样：

1. 确保USB转TTL已经和电脑连接好，供电正常；
2. 把IO0和GND用杜邦线接好；
3. 按一下RST复位键，让芯片以下载模式启动；
4. 在Arduino IDE里点击上传按钮。

烧录完成后还有一个容易忽略的步骤：一定要拔掉IO0和GND之间的杜邦线，再按一次RST复位键，让板子以正常模式启动并运行程序。如果你烧完发现板子没反应，先检查IO0是不是还连在GND上。

3. 开发环境搭建：Arduino IDE里三处关键配置

3.1 安装Arduino IDE

去Arduino官网下载IDE，我目前用的是2.x版本，界面比老版1.8.x清爽不少，自带代码补全和更顺手的串口监视器。如果你习惯1.8.x，整个配置逻辑也完全一样。

Windows下安装时建议选择为所有用户安装，避免后面出现文件写入权限问题。装完第一次打开，如果系统提示安装驱动，顺手装上。后面插USB转TTL模块时，CH340或CP2102的驱动能不能正常识别，直接决定了你能否烧录。

3.2 添加ESP32开发板管理器地址

这一步是整个配置流程里最核心的一步，很多教程一笔带过，结果用户在开发板管理器里根本搜不到esp32。

打开Arduino IDE后，进入 文件 -> 首选项（Windows）或 Arduino IDE -> 设置（macOS），找到“附加开发板管理器地址”，把下面这个ESP32官方JSON地址粘贴进去：

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

如果你之前添加过别的开发板地址，注意每个地址一行，不要把旧内容删掉。保存后，进入 工具 -> 开发板 -> 开发板管理器，搜索esp32，找到Espressif Systems发布的esp32包，点击安装。这个包体积比较大，下载时间取决于网络。安装完成后，开发板菜单下会出现一大串ESP32系列板卡名称。

3.3 选对开发板型号：AI Thinker ESP32-CAM

在 工具 -> 开发板 菜单里，找到ESP32 Arduino分类，然后选择AI Thinker ESP32-CAM。

这一步是新手最容易踩的坑：很多人去找名字叫“ESP32-CAM”的板卡，但Arduino的开发板菜单里其实没有这个名字，只有“AI Thinker ESP32-CAM”。如果你选了默认的ESP32 Dev Module，烧录也能烧进去，但程序跑起来会有各种奇怪问题，比如摄像头初始化失败、GPIO对不上导致功能混乱。

选完开发板型号，还要确认几个配置项：

• Flash Size：4MB，AI Thinker ESP32-CAM出厂基本都是4MB；
• Partition Scheme：默认即可，跑CameraWebServer的话4MB配置够用；
• Port：插入USB转TTL后这里会多出一个串口，Windows下一般是COM3或COM4，macOS下是/dev/cu.usbserial-xxx。

3.4 串口驱动：识别不了端口时先装驱动

插入USB转TTL后，如果电脑里的端口列表一直不出现新设备，先别怀疑板子坏了。CH340驱动在Windows上偶尔不会自动装好，CP2102也一样。

判断方法：Windows下打开设备管理器，看“端口（COM和LPT）”一栏里有没有新增设备，或者有没有带黄色感叹号的未知设备。如果是感叹号，右键更新驱动，或者去对应芯片厂商官网下载驱动安装。macOS下CH340通常能自动识别，不行就装对应的驱动包。

3.5 开发板包下载失败或网速慢的处理

下载arduino-esp32开发板包时，有时候速度极慢，甚至卡在Verifying。我试过比较有效的办法是换网络或换时间段重试。要是安装中途中断，再次安装时IDE可能会提示包已存在，这时候需要手动清理残留的包文件再重装。Windows下清理这个目录：

C:\Users\你的用户名\AppData\Local\Arduino15\packages

macOS下是：

~/Library/Arduino15/packages

把这个目录下的esp32相关文件夹删掉，再回到开发板管理器重新安装。虽然麻烦点，但能解决大部分安装不完整导致的隐藏问题。

4. 逐步烧录：从示例代码到浏览器出画面

4.1 打开官方CameraWebServer示例

安装好ESP32开发板包之后，Arduino IDE会自带一个官方示例：CameraWebServer。路径是：文件 -> 示例 -> ESP32 -> Camera -> CameraWebServer。

这个示例就是ESP32-CAM变成网络摄像头的关键代码。它做的事情概括起来就三步：初始化摄像头传感器、启动HTTP Web服务器、在网页上提供视频流和控制按钮。

第一次打开示例，先看代码顶部的注释段。里面有一堆#define CAMERA_MODEL_XXXX，这是给不同板卡预置的摄像头引脚定义。我们要用AI Thinker板卡，所以确保这行代码处于生效状态：

#define CAMERA_MODEL_AI_THINKER

其余型号的define保持注释状态即可。如果你用别的板卡，需要切换到对应型号，但本文只针对AI Thinker。

4.2 修改WiFi名称和摄像头型号

向下滚动代码，找到这两行：

const char* ssid = "你的WiFi名称"; const char* password = "你的WiFi密码";

改成你自己路由器的2.4G WiFi信息。这里有个硬性前提：ESP32-CAM只支持2.4GHz频段，不支持5G WiFi。如果家里路由器开着双频合一，建议先手动指定2.4G网络，或者暂时把5G关了测试。连不上5G信号不是硬件问题。

同时，在代码里还要确认当前生效的摄像头型号宏定义是CAMERA_MODEL_AI_THINKER。这两个地方改完，代码部分就完成了。

4.3 完整烧录流程：短接、复位、上传

把前面所有准备工作串一遍，确保每一步都到位：

1. 确认USB转TTL和ESP32-CAM接线正确：UOR接TXD，UOT接RXD，GND接GND，VCC接5V；
2. 确认Arduino IDE里开发板已选择AI Thinker ESP32-CAM；
3. 确认工具 -> 端口里已经选择了对应串口；
4. 用杜邦线短接IO0和GND；
5. 按一下RST复位键，进入下载模式；
6. 点击Arduino IDE左上角的上传箭头按钮，开始编译并上传。

点击上传后，程序会先编译一遍。第一次编译因为要缓存ESP32头文件和库，可能需要一两分钟，这是正常的。编译通过后，IDE底部日志区会显示Connecting...，然后看到烧录进度百分比。最后出现Hard resetting via RTS pin...，说明烧录完成。

4.4 烧录失败排查对照表

4.5 串口日志与拿到IP地址

烧录完成后，拔掉IO0和GND之间的杜邦线，按一下RST复位键，让板子正常启动。

打开Arduino IDE的串口监视器，把右下角波特率设为115200。CameraWebServer示例的串口输出默认就是这个波特率。如果一切正常，你会看到启动日志，最后一行类似：

WiFi connected Camera Ready! Use 'http://192.168.1.100' to connect

那个IP地址就是摄像头在局域网里的地址。复制到浏览器打开，就能看到摄像头的控制页面了。

如果串口监视器里完全没有输出，先检查三项：串口监视器波特率是不是115200、板子是否已经复位、供电是否正常。如果串口有输出但没有Camera Ready，说明摄像头初始化失败，多半是代码里摄像头型号选错，或者软排线接触不良。

5. 浏览器打开画面后：调参数、稳定供电、固定IP

5.1 网页端控制与参数调节

打开IP地址后，页面顶部有个“Start Stream”按钮，点击后浏览器开始接收摄像头画面。页面下方还有一些控制选项：

• Resolution：分辨率，包括QVGA（320x240）、VGA（640x480）、SVGA（800x600）等。分辨率越高越清晰，但延迟和带宽占用也越大；
• Quality：JPEG压缩质量，数值范围10到63，值越小画质越好但数据量越大；
• Brightness、Contrast：亮度、对比度调节，在光线复杂的环境里很好用。

我实际用下来比较舒服的设置是分辨率选VGA（640x480），质量调到15左右。这个组合在清晰度和流畅度之间比较平衡。如果只是盯着门口看个大概，QVGA就够了，延迟会明显更低。

5.2 为什么5分钟能搞定，但实际会遇到问题

标题说5分钟搞定，这指的是接线、配置、烧录都已经熟练的情况。现实中你可能会遇到这些问题：

• 画面是黑的，但网页能打开。常见原因是光线太暗、摄像头没初始化成功，或者软排线接触不良；
• 画面花屏、撕裂。多半是供电不足，或者WiFi信号弱导致图像数据丢包；
• 视频流卡顿、延迟高。这是ESP32-CAM的固有特点，毕竟是在2.4G WiFi下传输JPEG帧，它不是专业网络摄像头。想流畅一些，就降低分辨率、降低质量、减少网页端实时调节频次；
• 连接不稳定，偶尔掉线。检查WiFi信号强度，测试时尽量靠近路由器。

5.3 从代码层固定IP

官方示例默认是从路由器自动获取IP，这意味着板子每次重启，IP都可能变化。如果只是临时调试，每次看串口日志的IP也还行；但想做长期摄像头，建议在代码里固定IP，省得每次都去查。

在WiFi.begin()之前，先用WiFi.config()指定IP、网关、子网掩码：

IPAddress local_IP(192,168,1,200); IPAddress gateway(192,168,1,1); IPAddress subnet(255,255,255,0); WiFi.config(local_IP, gateway, subnet); WiFi.begin(ssid, password);

注意IP地址要避开路由器DHCP自动分配的范围，否则可能跟其他设备冲突。写进代码以后，板子每次启动都会用这个固定IP，稳定很多。

6. 进阶玩法：TF卡存储、外网访问与DIY扩展

6.1 定时拍照存TF卡的思路与代码骨架

官方示例只提供浏览器实时画面，如果你想做延时摄影或者存证类应用，可以在它的基础上改造成定时拍照存TF卡。

基本逻辑是调用esp_camera_fb_get()获取摄像头帧缓冲，再用SD_MMC接口把JPEG数据写入TF卡。代码骨架大概是这样的：

#include "SD_MMC.h" void setup() { if (!SD_MMC.begin()) { Serial.println("SD Card Mount Failed"); return; } // 摄像头初始化代码... } void loop() { camera_fb_t* fb = esp_camera_fb_get(); if (fb) { // 生成文件名，比如 /photo_001.jpg // 用SD_MMC打开文件并写入fb->buf，长度fb->len esp_camera_fb_return(fb); } delay(10000); // 每10秒拍一张 }

TF卡要格式化成FAT32，容量建议32G以内。一张JPEG几十KB到两百KB，日常用完全够。注意ESP32-CAM板载的SD_MMC引脚是固定的，直接用SD_MMC库即可，不需要额外配置引脚。

6.2 外网访问：先想清楚安全问题

默认情况下，ESP32-CAM的IP只在局域网内可访问，也就是连同一个WiFi的设备才能打开画面。如果人不在家里，又想看摄像头，就得考虑外网访问的问题。

这里我要多说一句安全的事。摄像头的画面是隐私数据，如果直接把摄像头端口暴露到公网，等于把家门钥匙放在门口脚垫下面，安全性很差。我不建议新手直接去路由器上做端口映射，更不要图省事把管理密码设成123456。

更稳妥的方向是：如果需要远程看，考虑使用正规的物联网云平台做设备接入和转发，通过平台分配的设备凭证来访问。这需要额外的学习和配置，但隐私安全远比自己暴露端口靠谱。如果只是在家看宠物、看3D打印机，我觉得局域网访问已经足够，没必要为了“在外面也能看”这个需求承担不必要的风险。

6.3 传感器扩展：PIR、云台、温湿度

ESP32-CAM不只是摄像头，它首先是一块完整的ESP32开发板，所有GPIO都能用：

• 接PIR人体红外传感器，做成有人经过就抓拍并报警的小装置；
• 接DHT11/DHT22温湿度传感器，做成环境监测节点；
• 加一个小舵机，做成能远程转动方向的云台摄像头；
• 结合MQTT协议，把抓拍到的图像信息推送到手机。

这些扩展都能建立在当前环境上，所以这篇教程真正留给你的，不只是“能看到画面”这个结果，而是一套完整的ESP32开发环境和调试思维。后面做任何ESP32项目，这些基础能力都能复用。

6.4 关于板子选购的一些建议

如果你还没买板子，或者想再买几块，我给几个建议：

• 优先选板载OV2640的版本，性价比最高，资料也最多；
• 注意看板子有没有IPEX天线座。带天线座的版本，可以外接天线增强信号，不加天线也能工作；
• 如果觉得外接USB转TTL模块太麻烦，可以买带底板的ESP32-CAM-MB版本，插Micro USB线就能下载程序，省去杜邦线，价格贵一点但新手友好度明显提升；
• 买的时候留意Flash容量，尽量选4MB版本，1MB的旧版在跑CameraWebServer时分区不够用，会很憋屈。

7. 最后聊聊我踩过的最深的坑

写到这，ESP32-CAM已经从一块“不知道拿来干嘛”的板子，变成了能在浏览器里出画面的网络摄像头。不过我猜你操作的时候，大概率还是会碰到我这篇没列到的问题。那就说个我自己的经历，算是给这次的教程收个尾。

我第一次拿到ESP32-CAM的时候，严格按照看到的所有教程走，结果烧录了三遍都卡在Connecting...。折腾了一整个晚上，换了杜邦线、换了USB转TTL模块、重装了Arduino IDE，全部没用。最后实在没办法，换了根Micro USB线，一次就过了。原因特别蠢：我之前用的那根线只能充电，电脑根本没识别到USB转TTL模块，所以IDE一直在空等。

这件事给我的教训很实在：做嵌入式开发，遇到问题先别急着怀疑代码和库，回头检查物理连接、供电、线材、端口这些最基础的条件，往往比研究代码更快解决问题。ESP32-CAM的配置本身并不复杂，最大的门槛恰恰是这些不起眼的细节。

如果你跟着这篇教程把画面跑起来了，恭喜，你现在拥有一块能自己改代码、自己扩展功能的开发板了。后面不管是接传感器、做延时摄影，还是学MQTT，都是顺理成章的事。踩坑的时候再回来翻翻这篇，至少能帮你省几个晚上的时间。