NodeMCU ESP8266声明pinMode后Serial无法工作问题求助

问题描述 #

开发NodeMCU ESP8266项目时，未添加pinMode(r, OUTPUT)等引脚配置语句时Serial正常输出，添加后Serial完全停止运行，移除这些语句后代码恢复正常。

核心原因 #

你定义的引脚编号直接占用了ESP8266的硬件Serial通信引脚：

• const int r = 1对应GPIO1（TX引脚），这是硬件Serial的默认发送引脚，负责输出Serial.print的内容
• const int b = 3对应GPIO3（RX引脚），是硬件Serial的接收引脚

当你执行pinMode(r, OUTPUT)和digitalWrite(r, LOW)时，GPIO1被强制设置为输出低电平，直接阻断了串口数据的发送通道，导致Serial完全无法工作。

解决方案 #

1. 更换非串口引脚：选择NodeMCU上不占用硬件Serial的引脚，修改引脚定义，比如：

const int r = 5;  // 对应NodeMCU板载D1引脚
const int g = 4;  // 对应NodeMCU板载D2引脚
const int b = 0;  // 对应NodeMCU板载D3引脚

2. 确认引脚映射：NodeMCU的板载引脚编号（D0-D8）与ESP8266的GPIO编号并非一一对应，务必对照官方引脚图选择空闲引脚，避免占用串口、SPI、I2C等关键功能引脚。
3. 备选方案（不推荐）：如果必须使用GPIO1/GPIO3，可以使用SoftwareSerial库创建软件串口，但硬件Serial的稳定性和传输速度更优，优先推荐更换引脚。

验证修改 #

修改引脚定义后，重新上传代码，Serial应该能恢复正常输出，同时LED引脚也能正常工作。

内容的提问来源于stack exchange，提问作者Chen Owen