macOS 下 ESP8266 烧录 LED 闪烁代码极简教程
一、前置准备
1. 确认硬件与数据线
- 硬件：ESP8266 开发板（主流为 NodeMCU 1.0 (ESP-12E Module)）
- 数据线：需为可传输数据的 USB 线（判断方法：连接 ESP8266 后终端执行
ls /dev/cu.*，能看到cu.usbserial-xxx类串口即符合要求）
2. 安装 USB 转串口驱动
ESP8266 开发板常用 CP210x 或 CH340 芯片，需安装对应驱动：
- CP210x 驱动：Silicon Labs 官方下载
- CH340 驱动：CH340 macOS 驱动
安装后需在「系统设置 → 隐私与安全性」允许对应软件运行，重启 Mac 生效。
二、安装 Arduino IDE
- 下载地址：Arduino IDE 官方下载
- 选择 macOS 版本下载，解压后将 Arduino 拖入「应用程序」文件夹。
三、配置 ESP8266 开发板支持
1. 添加 ESP8266 开发板地址
- 打开 Arduino IDE → 顶部菜单栏「Arduino → 偏好设置」
- 在「附加开发板管理器网址」输入框粘贴：
https://arduino.esp8266.com/stable/package_esp8266com_index.json - 点击「好」保存设置。
2. 安装 ESP8266 开发板支持包
- 点击「工具 → 开发板 → 开发板管理器」
- 在搜索框输入
esp8266，找到「ESP8266 by ESP8266 Community」，选择最新稳定版（如 3.1.2）点击「安装」（安装过程约 2-5 分钟，耐心等待）。
3. 选择 ESP8266 开发板与串口
- 「工具 → 开发板」：下拉找到「ESP8266 Boards」分类，选择
NodeMCU 1.0 (ESP-12E Module)（适配绝大多数 ESP8266 开发板）。 - 「工具 → 端口」：选择 ESP8266 对应的串口（格式为
/dev/cu.usbserial-xxx）。 - 默认配置（无需修改）：
- Flash Size：4M (3M SPIFFS)
- Upload Speed：115200
四、编写并烧录 LED 闪烁代码
1. 粘贴 ESP8266 专属代码
/* ESP8266 LED 闪烁代码（NodeMCU 板载 LED 引脚 2） */
const int ledPin = 2; // ESP8266 板载 LED 固定引脚
void setup() {
pinMode(ledPin, OUTPUT); // 设置引脚为输出模式
Serial.begin(115200); // 初始化串口（调试用）
Serial.println("ESP8266 LED 闪烁测试开始");
}
void loop() {
digitalWrite(ledPin, LOW); // 低电平点亮 LED
Serial.println("LED 亮");
delay(1000); // 亮 1 秒
digitalWrite(ledPin, HIGH); // 高电平熄灭 LED
Serial.println("LED 灭");
delay(1000); // 灭 1 秒
}
2. 烧录代码
- 点击 Arduino IDE 右上角「上传」按钮（向右箭头）；
- ESP8266 (NodeMCU) 无需手动按 BOOT/RST 键，会自动进入烧录模式；
- 看到如下提示即烧录成功：
Writing at 0x00000000... (100 %) Wrote 277888 bytes (173229 compressed) at 0x00000000 in 15.3 seconds... Hash of data verified. Leaving... Hard resetting via RTS pin...
五、验证结果
烧录完成后，ESP8266 板载 LED 会每秒闪烁一次；打开「工具 → 串口监视器」（波特率选择 115200），可看到「LED 亮/灭」的调试日志，说明代码运行正常。
六、常见问题排查
- 串口权限不足：终端执行
sudo chmod 666 /dev/cu.usbserial-xxx（替换为实际串口名称），重新插拔 ESP8266； - 上传失败/超时：将「Upload Speed」改为 9600 或 57600 重试，或更换可传输数据的 USB 线；
- 串口未识别：重新安装 USB 驱动，重启 Mac 后再次插拔 ESP8266。
七、设置网络代理
- 我使用的是 Clash For Meta
- IDE -> 首选项 -> 网络代理 -> socket5 -> 127.0.0.1:7890
总结
- 核心步骤：安装驱动 → 安装 Arduino IDE → 配置 ESP8266 开发板支持 → 选择正确板型和串口 → 烧录专属代码。
- 关键要点：ESP8266 板载 LED 引脚为 2，且低电平点亮，烧录时无需手动按按键。
- 排障重点：优先确认数据线可传数据、串口权限和开发板选型正确。