Arduino ESP32 开发环境搭建5 步装好 arduino-esp32 核心10 分钟跑通第一个固件【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32很多初烧 ESP32 的人不是败在代码上而是败在环境上驱动装不装、板子管理器地址填哪个、串口开不开权限随便一个细节就能卡掉一下午。其实核心思路很简单装好 arduino-esp32 这套官方 Arduino 核心IDE 就能直接编译和烧录 ESP32 固件后面全部回到熟悉的 sketch 写法。这个项目就是乐鑫官方维护的 Arduino core for the ESP32 family of SoCs覆盖 ESP32、S2、S3、C3、C6 等全系列芯片当前稳定版为 3.3.11。本教程按装核心 → 选板子 → 刷一个小程序验证 → 排常见坑的路径走一遍照着做基本不会来回折腾。动手前先把这几样备齐开始之前列个清单缺哪样补哪样操作系统Windows64 位32 位系统不支持 3.x 核心、macOS 或 Linux 均可Arduino IDE从 arduino.cc 下载 1.8 以上版本没有 IDE 先装它核心是往 IDE 里装的硬件一块 ESP32 开发板新手推荐 ESP32-DevKitC一根带数据线芯的 USB 线——只用来充电的线后面会让你反复怀疑人生网络下载核心库要拉取约百兆的工具链网络稳定为宜国内网络访问 GitHub 不稳的话可改用乐鑫提供的 Jihulab 镜像源下面这张是 ESP32-DevKitC 的引脚图后面接线或找 GPIO0BOOT 键旁边那颗时会用到第 1 步在 IDE 首选项里添加板管理器源打开 Arduino IDE进入 File → Preferences。在 Additional Boards Manager URLs 输入框里填入官方稳定版索引地址https://espressif.github.io/arduino-esp32/package_esp32_index.json国内网络如果下载慢或失败可以换成乐鑫镜像地址https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/gh-pages/package_esp32_index_cn.json详见项目文档 docs/en/installing.rst。填完点 OK不需要重启 IDE。第 2 步在 Boards Manager 里安装 ESP32 核心菜单走 Tools → Board → Boards Manager搜索框输入esp32。列表里会出现 espressif 官方的 esp32 平台选中后点 Install。国内用户注意用镜像源装的是带-cn后缀的版本且不支持自动更新以后升级要手动再装一次。安装过程要拉编译器和工具链耐心等进度条走完视网速 1~5 分钟。第 3 步重启 IDE选择板子和串口装完重启 Arduino IDE重启这步很多人跳过结果菜单里找不到板子。然后在两个下拉框里做选择Tools → Board选中你的板型DevKitC 用户选 ESP32S3 Dev Module 之外的 ESP32 Dev Module注意选和你芯片一致的型号Tools → Port插上开发板后这里会多出一个 COM 口Windows或/dev/tty*Linux/macOS选它端口列表为空时多半是线的问题或驱动没装好先别急着怀疑核心没装成功。跑一个最小 WiFi 扫描程序验证环境通了验证不玩花活就用 ESP32 最拿手的一件事——扫 WiFi。菜单 File → Examples → WiFi → WiFiScan打开示例后直接点上传Upload。打开串口监视器波特率选115200。预期输出大致是每 5 秒滚动一批 SSID带信号强度scan WiFi -1: MyHomeRouter (-72) -2: Neighbor_5G (-85)能看到 SSID 和负数 RSSI 值说明编译、上传、串口三条链路全部通了。如果一台都扫不到先确认板子在 2.4G 频段环境里再检查 WiFi 天线是否装正。三个最高频的坑提前排掉症状上传时报Failed to connect to ESP32: Timed out waiting for packet header原因常见三种——用的是纯充电线没数据芯、板子没进下载模式、USB hub 供电不稳。解决换一根确定的数据线直插电脑再点一次上传的同时按住板子上的BOOT键等进度走两步再松手仍不行就避开 USB hub 换口。症状Linux 下编译报python: executable file not found in $PATH原因系统里只有python3没有python别名工具链按旧名调用。解决执行sudo apt install python-is-python3建一个软链即可。症状Linux 下串口打不开提示权限不足原因当前用户不在dialout组里。解决sudo usermod -a -G dialout $USER然后注销重新登录只关终端不生效。装好之后的三个进阶动作OTA 无线刷写。第一次用线刷上去之后可以装上 ArduinoOTA 库示例在 File → Examples → ArduinoOTA后续更新固件直接走 WiFi拔线刷板的麻烦就省了。前提是板子已经连上你的局域网。分区表按需调整。Flash 里程序区和存储区的划分由分区表决定。项目 tools/partitions/ 目录里放了 49 份现成模板csv 格式需要更大的 SPIFFS/LittleFS 空间时挑一份用就行改完记得在 Tools → Partition Scheme 里挂上。版本管理。Boards Manager 右上角能看到当前版本和可更新提示。建议升级时点 Select Oldest 保留旧版做回退别只留一个版本项目文档 docs/en/troubleshooting.rst 里记录了更多已知问题的排查方法遇到怪报错先翻它。接下来该做什么在 Boards Manager 确认 esp32 平台安装成功版本 3.xBoard 和 Port 两项都能正常选中WiFi 扫描示例输出正常115200 波特率把 BOOT 键手动下载模式记在小本上下次卡壳 10 秒解决到这里环境就算立住了。后面的事就是写自己的 sketch串口、GPIO、WiFi、BLE项目 libraries/ 目录下 WiFi、BLE、WebServer、ESP32 这些官方库都有配套示例点菜单就能跑。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Arduino ESP32 开发环境搭建：5 步装好 arduino-esp32 核心，10 分钟跑通第一个固件
Arduino ESP32 开发环境搭建5 步装好 arduino-esp32 核心10 分钟跑通第一个固件【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32很多初烧 ESP32 的人不是败在代码上而是败在环境上驱动装不装、板子管理器地址填哪个、串口开不开权限随便一个细节就能卡掉一下午。其实核心思路很简单装好 arduino-esp32 这套官方 Arduino 核心IDE 就能直接编译和烧录 ESP32 固件后面全部回到熟悉的 sketch 写法。这个项目就是乐鑫官方维护的 Arduino core for the ESP32 family of SoCs覆盖 ESP32、S2、S3、C3、C6 等全系列芯片当前稳定版为 3.3.11。本教程按装核心 → 选板子 → 刷一个小程序验证 → 排常见坑的路径走一遍照着做基本不会来回折腾。动手前先把这几样备齐开始之前列个清单缺哪样补哪样操作系统Windows64 位32 位系统不支持 3.x 核心、macOS 或 Linux 均可Arduino IDE从 arduino.cc 下载 1.8 以上版本没有 IDE 先装它核心是往 IDE 里装的硬件一块 ESP32 开发板新手推荐 ESP32-DevKitC一根带数据线芯的 USB 线——只用来充电的线后面会让你反复怀疑人生网络下载核心库要拉取约百兆的工具链网络稳定为宜国内网络访问 GitHub 不稳的话可改用乐鑫提供的 Jihulab 镜像源下面这张是 ESP32-DevKitC 的引脚图后面接线或找 GPIO0BOOT 键旁边那颗时会用到第 1 步在 IDE 首选项里添加板管理器源打开 Arduino IDE进入 File → Preferences。在 Additional Boards Manager URLs 输入框里填入官方稳定版索引地址https://espressif.github.io/arduino-esp32/package_esp32_index.json国内网络如果下载慢或失败可以换成乐鑫镜像地址https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/gh-pages/package_esp32_index_cn.json详见项目文档 docs/en/installing.rst。填完点 OK不需要重启 IDE。第 2 步在 Boards Manager 里安装 ESP32 核心菜单走 Tools → Board → Boards Manager搜索框输入esp32。列表里会出现 espressif 官方的 esp32 平台选中后点 Install。国内用户注意用镜像源装的是带-cn后缀的版本且不支持自动更新以后升级要手动再装一次。安装过程要拉编译器和工具链耐心等进度条走完视网速 1~5 分钟。第 3 步重启 IDE选择板子和串口装完重启 Arduino IDE重启这步很多人跳过结果菜单里找不到板子。然后在两个下拉框里做选择Tools → Board选中你的板型DevKitC 用户选 ESP32S3 Dev Module 之外的 ESP32 Dev Module注意选和你芯片一致的型号Tools → Port插上开发板后这里会多出一个 COM 口Windows或/dev/tty*Linux/macOS选它端口列表为空时多半是线的问题或驱动没装好先别急着怀疑核心没装成功。跑一个最小 WiFi 扫描程序验证环境通了验证不玩花活就用 ESP32 最拿手的一件事——扫 WiFi。菜单 File → Examples → WiFi → WiFiScan打开示例后直接点上传Upload。打开串口监视器波特率选115200。预期输出大致是每 5 秒滚动一批 SSID带信号强度scan WiFi -1: MyHomeRouter (-72) -2: Neighbor_5G (-85)能看到 SSID 和负数 RSSI 值说明编译、上传、串口三条链路全部通了。如果一台都扫不到先确认板子在 2.4G 频段环境里再检查 WiFi 天线是否装正。三个最高频的坑提前排掉症状上传时报Failed to connect to ESP32: Timed out waiting for packet header原因常见三种——用的是纯充电线没数据芯、板子没进下载模式、USB hub 供电不稳。解决换一根确定的数据线直插电脑再点一次上传的同时按住板子上的BOOT键等进度走两步再松手仍不行就避开 USB hub 换口。症状Linux 下编译报python: executable file not found in $PATH原因系统里只有python3没有python别名工具链按旧名调用。解决执行sudo apt install python-is-python3建一个软链即可。症状Linux 下串口打不开提示权限不足原因当前用户不在dialout组里。解决sudo usermod -a -G dialout $USER然后注销重新登录只关终端不生效。装好之后的三个进阶动作OTA 无线刷写。第一次用线刷上去之后可以装上 ArduinoOTA 库示例在 File → Examples → ArduinoOTA后续更新固件直接走 WiFi拔线刷板的麻烦就省了。前提是板子已经连上你的局域网。分区表按需调整。Flash 里程序区和存储区的划分由分区表决定。项目 tools/partitions/ 目录里放了 49 份现成模板csv 格式需要更大的 SPIFFS/LittleFS 空间时挑一份用就行改完记得在 Tools → Partition Scheme 里挂上。版本管理。Boards Manager 右上角能看到当前版本和可更新提示。建议升级时点 Select Oldest 保留旧版做回退别只留一个版本项目文档 docs/en/troubleshooting.rst 里记录了更多已知问题的排查方法遇到怪报错先翻它。接下来该做什么在 Boards Manager 确认 esp32 平台安装成功版本 3.xBoard 和 Port 两项都能正常选中WiFi 扫描示例输出正常115200 波特率把 BOOT 键手动下载模式记在小本上下次卡壳 10 秒解决到这里环境就算立住了。后面的事就是写自己的 sketch串口、GPIO、WiFi、BLE项目 libraries/ 目录下 WiFi、BLE、WebServer、ESP32 这些官方库都有配套示例点菜单就能跑。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考