装 Arduino IDE
到 Arduino 官网下载 Arduino IDE 安装包，Windows、macOS、Linux 都有。建议用 2.x 版本，界面和开发板管理都比老的 1.8 好用。安装过程按默认选项走完即可。
添加 ESP32 板卡源
ESP32 支持不在 Arduino IDE 默认包里，要先添加乐鑫官方的板卡索引。
打开菜单 文件、首选项（Windows/Linux）或 Arduino IDE、设置（macOS），找到「其他开发板管理器地址」，填入官方稳定版地址：
https://espressif.github.io/arduino-esp32/package_esp32_index.json国内直连 GitHub 慢或不稳定，乐鑫官方提供了国内镜像源，推荐国内用户直接用这个：
https://jihulab.com/esp-mirror/espressif/arduino-esp32/-/raw/gh-pages/package_esp32_index_cn.json填好后点确定保存。
安装 esp32 平台
打开 工具、开发板、开发板管理器，搜索 esp32，安装乐鑫官方的 esp32 平台包。用国内镜像源的用户，注意选择带 -cn 后缀的版本包，并且要手动更新，官方说明该地区不支持自动更新。
包比较大（包含工具链），安装需要几分钟，装完重启 Arduino IDE。
验证安装
- 用 USB 线连接 ESP32 开发板。
- 在 工具、开发板 里选择自己的板型，经典款选 ESP32 Dev Module，C3 选 ESP32C3 Dev Module，C6 选 ESP32C6 Dev Module。
- 在 工具、端口 里选中开发板对应的串口。Windows 下形如 COM3，Linux 下形如 /dev/ttyUSB0 或 /dev/ttyACM0，macOS 下形如 /dev/cu.usbserial。
- 打开 文件、示例、01.Basics、Blink，点上传。板载 LED 开始闪烁就说明环境通了。
提示：部分老款 ESP32 板上传时要按住板上的 BOOT 键再点上传，看到 Connecting 后松开。新款板多带自动下载电路，不需要这个操作。
常见问题
- 端口列表是空的：数据线可能是纯充电线，换一根能传数据的；或没装 USB 转串口驱动，兼容板常见 CH340 或 CP2102 芯片，到芯片厂商官网下载驱动。
- 板卡源下载失败：确认地址没有多余空格，国内用户换上面的 jihulab 镜像地址。
- 上传报 A fatal error occurred: Failed to connect to ESP32：多数是没进下载模式，按上面的 BOOT 键方法重试。
下一步
环境通了以后，到第一个程序页读懂 Blink 和串口输出，正式开始 ESP32 编程。