Arduino ESP32 安装与环境配置指南从零到第一次上传成功的两条路径【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32Arduino ESP32 是面向 ESP32 系列 SoC 的 Arduino 核心包本文的 Arduino ESP32 安装指把这个核心放进开发环境让 Arduino IDE 能为 ESP32 系列芯片编译并上传程序。适合能看懂命令行、但没装过这个核心的开发者花 2 分钟选一条路径照着步骤做完用可观察的标志确认装好了出问题也知道先查哪里。先花两分钟选路板载管理器安装与手动安装对比两条路径的目标相同让 IDE 里出现可用的 ESP32 工具链。差别在网络要求和后续维护成本。路径环境要求耗时可维护性适用人群板载管理器安装能访问官方源或国内镜像源约 10 分钟IDE 自动更新基本免维护网络正常、想要稳定版的大多数人手动源码安装git 与 Python 3 可用2030 分钟git pull 加重跑脚本即可版本完全可控离线部署、企业环境、需要固定版本的人动手前过一遍这份清单✅ Arduino IDE 为 1.6.4 及以上版本首选项里可查版本低于它没有板载管理器网络能访问官方源或 Jihulab 镜像源二选一即可sketchbook作品目录路径中没有中文和空格手动路径额外需要git 和 Python 3 已安装Linux 用户确认当前用户可访问串口后文习惯部分有做法路径一板载管理器安装填入官方源地址三步完成准备确认 IDE 版本满足要求后打开「文件 首选项」macOS 为「Arduino IDE 首选项」找到 Additional Boards Manager URLs附加开发板管理器网址一栏点击右侧编辑按钮。执行在输入框填入稳定版源地址https://espressif.github.io/arduino-esp32/package_esp32_index.json需要尝鲜的开发版把文件名换成package_esp32_dev_index.json。多个地址可用英文逗号分隔但建议一次只留一个方便出问题时定位。打开「工具 开发板 板载管理器」搜索esp32找到由 Espressif Systems 发布的条目点击安装等待下载完成。 国内网络访问官方源不稳定时改用 Jihulab 镜像源地址https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/gh-pages/package_esp32_index_cn.json。走镜像源时安装必须选带-cn后缀的版本镜像源不支持自动更新日后升级要手动重新选择-cn版本。重启 Arduino IDE。验收✅ 重启后「工具 开发板」菜单出现 ESP32 Dev Module 等 ESP32 系列型号「文件 示例 ESP32」下有官方示例工程板载管理器中 esp32 条目显示已安装版本号上传任意草图输出窗口最后出现 Done uploading。路径二手动源码安装把 arduino-esp32 仓库放进 sketchbook准备安装 git 和 Python 3终端里python提示命令未找到时改用python3。⚠️ 该工具链不再支持 Windows 32 位系统老机器上此路径走不通请回到路径一。确认 sketchbook 位置Windows 默认C:\Users\用户名\Documents\ArduinomacOS 为~/Documents/ArduinoLinux 为~/Arduino以 IDE 首选项显示的为准。执行把仓库 clone 到 sketchbook 的hardware/espressif/esp32下路径按你的系统调整mkdir -p ~/Arduino/hardware/espressif cd ~/Arduino/hardware/espressif git clone https://gitcode.com/GitHub_Trending/ar/arduino-esp32 esp32Windows 上 clone 完成后还需在仓库根目录执行git submodule update --init --recursive初始化子模块。然后进入 tools 目录下载工具链cd esp32/tools python3 get.py脚本会拉取 xtensa 交叉编译器、esptool 等全部工具下载完成后再重启 IDE。验收✅ tools 目录下出现dist、sdk等子目录及已下载的工具文件与下图一致重启 IDE 后「工具 开发板」出现 ESP32 系列型号编译并上传任一示例成功输出以 Done uploading 结束。文件落在哪Arduino ESP32 核心结构速览装完之后文件只可能落在两个位置板载管理器路径在 Arduino15 目录下的 packages 中Linux/macOS 为~/.arduino15/packages/esp32Windows 在%LOCALAPPDATA%\Arduino15手动路径在sketchbook/hardware/espressif/esp32。两条路打开目录看到的结构一致记住四块顶层配置文件boards.txt定义受支持的开发板platform.txt定义编译规则package.json携带版本信息当前仓库版本为 3.3.11具体以仓库当前 release 为准cores/esp32/HAL 硬件抽象层与 Arduino API 实现esp32-hal-gpio.c、esp32-hal-i2c.c、esp32-hal-spi.c等文件对接具体外设Arduino.h、WString、Stream提供通用接口variants/每块开发板的pins_arduino.h引脚定义换板子就是换这里的映射libraries/ 与 tools/WiFi、BLE、HTTPClient 等随核心附带的库以及 get.py、espota.py 等工具脚本。上图解释了 HAL 层的分工SPI、I2S、UART 等外设信号都经 GPIO 矩阵连到物理焊盘cores 里的 hal 文件就是 Arduino API 与这套路由机制之间的桥。装不上时先做的三件自查卡住时别靠猜按表先问问题、再动手现象先问自己对应动作开发板菜单里没有 ESP32源地址填了吗IDE 重启了吗镜像源是否误选了不带 -cn 的版本重新填入网址重启 IDE再走一次安装下载中断或校验失败网络能通源站吗本地是否残留了半截缓存文件换镜像源或清空 Arduino15 目录下的 staging 与 esp32 子目录后重试编译提示缺工具或未知开发板手动路径get.py 是否跑完核心是否位于 sketchbook 的 hardware 目录下重跑 get.py或把整个 esp32 目录挪到默认 sketchbook 路径下最短兜底动作三件都试过仍不行就删掉整个 esp32 目录从默认 sketchbook 路径重做一次路径务必不含中文和空格。装好后要养成的三个习惯先编译一遍示例打开「文件 示例 ESP32 WiFi WiFiScan」编译一次失败说明环境没配全先修环境再写代码。把板和串口固定下来工具菜单里选与实际一致的型号上传前核对 COM 口上传中断时按住 BOOT 键再点上传。升级用固定动作板载路径用板载管理器手动路径git pull后重跑 get.py大版本跨度先读仓库 docs 里的 2.x 到 3.x 迁移指南版本号以仓库当前 release 为准。Linux 提前给串口权限把用户加入 dialout 组避免每次上传都报权限错误。收尾从装好到第一次上传的四步按开头的对比表选定路径按「准备 → 执行 → 验收」走完逐项核对验收标志出问题先查三行自查表最后才考虑换路径重做编译一次 WiFiScan 示例确认环境可用。延伸阅读均为仓库内文件安装文档源文件核心源码工具脚本安装验收通过后打开任意一个示例接下来挡你的就是代码而不是环境了。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Arduino ESP32 安装与环境配置指南：从零到第一次上传成功的两条路径
Arduino ESP32 安装与环境配置指南从零到第一次上传成功的两条路径【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32Arduino ESP32 是面向 ESP32 系列 SoC 的 Arduino 核心包本文的 Arduino ESP32 安装指把这个核心放进开发环境让 Arduino IDE 能为 ESP32 系列芯片编译并上传程序。适合能看懂命令行、但没装过这个核心的开发者花 2 分钟选一条路径照着步骤做完用可观察的标志确认装好了出问题也知道先查哪里。先花两分钟选路板载管理器安装与手动安装对比两条路径的目标相同让 IDE 里出现可用的 ESP32 工具链。差别在网络要求和后续维护成本。路径环境要求耗时可维护性适用人群板载管理器安装能访问官方源或国内镜像源约 10 分钟IDE 自动更新基本免维护网络正常、想要稳定版的大多数人手动源码安装git 与 Python 3 可用2030 分钟git pull 加重跑脚本即可版本完全可控离线部署、企业环境、需要固定版本的人动手前过一遍这份清单✅ Arduino IDE 为 1.6.4 及以上版本首选项里可查版本低于它没有板载管理器网络能访问官方源或 Jihulab 镜像源二选一即可sketchbook作品目录路径中没有中文和空格手动路径额外需要git 和 Python 3 已安装Linux 用户确认当前用户可访问串口后文习惯部分有做法路径一板载管理器安装填入官方源地址三步完成准备确认 IDE 版本满足要求后打开「文件 首选项」macOS 为「Arduino IDE 首选项」找到 Additional Boards Manager URLs附加开发板管理器网址一栏点击右侧编辑按钮。执行在输入框填入稳定版源地址https://espressif.github.io/arduino-esp32/package_esp32_index.json需要尝鲜的开发版把文件名换成package_esp32_dev_index.json。多个地址可用英文逗号分隔但建议一次只留一个方便出问题时定位。打开「工具 开发板 板载管理器」搜索esp32找到由 Espressif Systems 发布的条目点击安装等待下载完成。 国内网络访问官方源不稳定时改用 Jihulab 镜像源地址https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/gh-pages/package_esp32_index_cn.json。走镜像源时安装必须选带-cn后缀的版本镜像源不支持自动更新日后升级要手动重新选择-cn版本。重启 Arduino IDE。验收✅ 重启后「工具 开发板」菜单出现 ESP32 Dev Module 等 ESP32 系列型号「文件 示例 ESP32」下有官方示例工程板载管理器中 esp32 条目显示已安装版本号上传任意草图输出窗口最后出现 Done uploading。路径二手动源码安装把 arduino-esp32 仓库放进 sketchbook准备安装 git 和 Python 3终端里python提示命令未找到时改用python3。⚠️ 该工具链不再支持 Windows 32 位系统老机器上此路径走不通请回到路径一。确认 sketchbook 位置Windows 默认C:\Users\用户名\Documents\ArduinomacOS 为~/Documents/ArduinoLinux 为~/Arduino以 IDE 首选项显示的为准。执行把仓库 clone 到 sketchbook 的hardware/espressif/esp32下路径按你的系统调整mkdir -p ~/Arduino/hardware/espressif cd ~/Arduino/hardware/espressif git clone https://gitcode.com/GitHub_Trending/ar/arduino-esp32 esp32Windows 上 clone 完成后还需在仓库根目录执行git submodule update --init --recursive初始化子模块。然后进入 tools 目录下载工具链cd esp32/tools python3 get.py脚本会拉取 xtensa 交叉编译器、esptool 等全部工具下载完成后再重启 IDE。验收✅ tools 目录下出现dist、sdk等子目录及已下载的工具文件与下图一致重启 IDE 后「工具 开发板」出现 ESP32 系列型号编译并上传任一示例成功输出以 Done uploading 结束。文件落在哪Arduino ESP32 核心结构速览装完之后文件只可能落在两个位置板载管理器路径在 Arduino15 目录下的 packages 中Linux/macOS 为~/.arduino15/packages/esp32Windows 在%LOCALAPPDATA%\Arduino15手动路径在sketchbook/hardware/espressif/esp32。两条路打开目录看到的结构一致记住四块顶层配置文件boards.txt定义受支持的开发板platform.txt定义编译规则package.json携带版本信息当前仓库版本为 3.3.11具体以仓库当前 release 为准cores/esp32/HAL 硬件抽象层与 Arduino API 实现esp32-hal-gpio.c、esp32-hal-i2c.c、esp32-hal-spi.c等文件对接具体外设Arduino.h、WString、Stream提供通用接口variants/每块开发板的pins_arduino.h引脚定义换板子就是换这里的映射libraries/ 与 tools/WiFi、BLE、HTTPClient 等随核心附带的库以及 get.py、espota.py 等工具脚本。上图解释了 HAL 层的分工SPI、I2S、UART 等外设信号都经 GPIO 矩阵连到物理焊盘cores 里的 hal 文件就是 Arduino API 与这套路由机制之间的桥。装不上时先做的三件自查卡住时别靠猜按表先问问题、再动手现象先问自己对应动作开发板菜单里没有 ESP32源地址填了吗IDE 重启了吗镜像源是否误选了不带 -cn 的版本重新填入网址重启 IDE再走一次安装下载中断或校验失败网络能通源站吗本地是否残留了半截缓存文件换镜像源或清空 Arduino15 目录下的 staging 与 esp32 子目录后重试编译提示缺工具或未知开发板手动路径get.py 是否跑完核心是否位于 sketchbook 的 hardware 目录下重跑 get.py或把整个 esp32 目录挪到默认 sketchbook 路径下最短兜底动作三件都试过仍不行就删掉整个 esp32 目录从默认 sketchbook 路径重做一次路径务必不含中文和空格。装好后要养成的三个习惯先编译一遍示例打开「文件 示例 ESP32 WiFi WiFiScan」编译一次失败说明环境没配全先修环境再写代码。把板和串口固定下来工具菜单里选与实际一致的型号上传前核对 COM 口上传中断时按住 BOOT 键再点上传。升级用固定动作板载路径用板载管理器手动路径git pull后重跑 get.py大版本跨度先读仓库 docs 里的 2.x 到 3.x 迁移指南版本号以仓库当前 release 为准。Linux 提前给串口权限把用户加入 dialout 组避免每次上传都报权限错误。收尾从装好到第一次上传的四步按开头的对比表选定路径按「准备 → 执行 → 验收」走完逐项核对验收标志出问题先查三行自查表最后才考虑换路径重做编译一次 WiFiScan 示例确认环境可用。延伸阅读均为仓库内文件安装文档源文件核心源码工具脚本安装验收通过后打开任意一个示例接下来挡你的就是代码而不是环境了。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考