1. 拿到ESP8266别急着写代码，先把AT指令聊明白
很多人拿到ESP8266模块的第一反应是打开Arduino IDE，找库、写代码、点上传，结果编译报错、烧录失败、串口没反应，折腾一整天连模块是死是活都不知道。我当初也是这么过来的，后来才想明白一个道理：ESP8266本质上是一个带Wi-Fi功能的单片机，它出厂时通常烧录了AT固件，你可以把它当成一个"听话的通信模块"，用一串简单的文本指令就能让它连上路由器、建立TCP连接、发数据。这套指令就是AT指令集。
AT指令调试是ESP8266开发的第一道门槛，也是最容易被跳过的一步。跳过它的代价是什么？你分不清问题出在硬件接线、供电、串口波特率，还是出在代码逻辑上。而如果你先用AT指令把模块跑通，你就拥有了一个可靠的"基准线"——模块能连Wi-Fi、能收发数据，说明硬件和固件都没问题，后面写Arduino代码时再出问题，范围就缩小到了代码本身。
这篇文章适合谁看？如果你手里有一块ESP8266模块（不管是ESP-01、ESP-01S、NodeMCU还是Wemos D1 mini），想搞清楚它到底怎么用，想在不写一行代码的情况下先让它连上网，那这篇内容就是为你准备的。我会从接线、供电、串口工具选择讲起，一直讲到常用AT指令的逐条实测、返回值的含义解读，以及那些文档里不会写的坑。全程基于实际调试经验，参数和步骤都可以直接照着做。
2. 调试前的硬件准备与接线方案
2.1 模块选型与引脚功能速查
ESP8266的模块形态很多，但核心引脚就那么几个。先搞清楚你手里的是什么板子，这决定了你需要不需要额外的电平转换电路。
| 模块型号 | 引脚间距 | 是否自带USB转串口 | 供电要求 | 适合人群 |
|---|---|---|---|---|
| ESP-01 / ESP-01S | 2.54mm | 否 | 3.3V，峰值300mA+ | 有USB-TTL工具的老手 |
| NodeMCU | 2.54mm | 是 | 5V Micro USB | 新手首选 |
| Wemos D1 mini | 2.54mm | 是 | 5V Micro USB | 新手首选 |
| ESP-12F | 2.54mm | 否 | 3.3V | 需要自己画板子的 |
如果你手里是ESP-01或ESP-01S，那必须配一个USB转TTL工具（常见的是CH340或CP2102芯片的）。NodeMCU和Wemos D1 mini自带USB接口，插上电脑就能用，省事很多。
ESP-01的引脚定义要记牢：VCC和CH_PD（有时标EN）都要接3.3V，GND接GND，TX接USB-TTL的RX，RX接USB-TTL的TX。GPIO0悬空或接高电平是运行模式，接低电平是烧录模式。GPIO2一般悬空即可。
注意：ESP8266的IO口是3.3V电平，绝对不能直接接5V的TX。虽然有些USB-TTL工具的TX是3.3V电平，但很多廉价工具输出的是5V，长期接上去会烧模块。保险起见，在USB-TTL的TX和ESP8266的RX之间串一个1kΩ电阻做限流，或者用专用的电平转换模块。
2.2 供电问题：最容易翻车的地方
我见过太多人卡在供电上。ESP8266在发射Wi-Fi信号瞬间的电流可以冲到300mA甚至更高，而USB-TTL工具上的3.3V引脚通常只能提供100mA左右。结果就是：模块能上电，串口能打印启动信息，但一执行连Wi-Fi的AT指令就重启或死机。
解决方案有三个：
- 用独立的3.3V稳压模块给ESP8266供电，USB-TTL只负责通信，不负责供电。这是最稳的方案。
- 在ESP8266的VCC和GND之间并联一个100μF以上的电解电容，再并一个0.1μF的陶瓷电容，用来吸收电流尖峰。
- 直接用NodeMCU或Wemos D1 mini，它们板载了稳压电路，USB供电足够。
实测下来，方案1和方案3最省心。如果你非要用USB-TTL的3.3V引脚供电，至少加电容，并且把串口工具的波特率降到74880或9600试试，降低瞬间电流需求。
2.3 串口工具的选择与配置
串口调试工具有很多选择，我按使用场景推荐几个：
- Windows平台：串口助手（SSCOM）、XCOM、PuTTY。SSCOM最常用，支持HEX显示、定时发送、多条指令预设，调试AT指令很方便。
- macOS/Linux平台：minicom、screen、picocom。命令行工具，轻量高效。用
screen /dev/ttyUSB0 115200就能连上。 - 跨平台：Arduino IDE自带的串口监视器也能用，但功能比较基础，不适合频繁发指令的场景。
配置参数：波特率通常选115200（出厂AT固件的默认值），数据位8，停止位1，校验位无，流控无。但要注意，有些批次的ESP-01出厂固件波特率是9600或74880，如果115200下全是乱码，依次试这几个值。
实操心得：ESP8266上电时会先以74880波特率打印一段启动信息，然后才切换到AT固件的波特率。所以如果你在115200下看到开头一段乱码，后面正常，那是正常的，不用管。
3. AT指令逐条实测与返回值解读
3.1 基础测试指令：确认模块活着
接好线、打开串口工具后，先发一条最简单的指令：
AT如果模块正常，会返回：
OK如果没反应，检查接线、波特率、供电。如果返回乱码，大概率是波特率不对。如果返回ERROR，说明固件可能有问题，需要重新烧录AT固件。
接下来测试固件版本：
AT+GMR返回内容类似：
AT version:1.7.4.0 SDK version:3.0.4 compile time:... OK这个信息很重要，不同版本的AT固件支持的指令集有差异。比如1.7以上的版本支持AT+CWJAP的更多参数，老版本可能不支持。记下你的版本号，后面查指令手册时对号入座。
3.2 Wi-Fi连接指令：让模块上网
设置工作模式：
AT+CWMODE=1参数含义：1=Station模式（作为客户端连路由器），2=AP模式（自己当热点），3=Station+AP共存。调试阶段先用1。
返回OK后，扫描周围Wi-Fi：
AT+CWLAP会返回一个列表，包含SSID、信号强度、加密方式等信息。这一步可以确认模块的射频部分工作正常。
连接Wi-Fi：
AT+CWJAP="你的WiFi名称","你的WiFi密码"成功返回OK，失败返回ERROR或+CWJAP:3（密码错误）等错误码。连接过程可能需要几秒钟，耐心等。
注意：ESP8266只支持2.4GHz频段，不支持5GHz。如果你的路由器是双频合一的，确保连的是2.4G的那个SSID。另外，SSID和密码里的特殊字符可能需要转义，建议先用纯字母数字的密码测试。
查询连接状态：
AT+CWJAP?返回当前连接的SSID和IP地址。看到IP就说明真的连上了。
3.3 TCP通信指令：收发数据
建立TCP连接：
AT+CIPSTART="TCP","192.168.1.100",8080参数依次是协议类型、目标IP、目标端口。返回CONNECT表示连接成功，ERROR表示失败（目标不可达、端口未监听等）。
发送数据前要设置发送长度：
AT+CIPSEND=5返回>后，输入5个字符的数据，比如hello，模块会发送出去并返回SEND OK。
接收数据时，模块会主动打印+IPD,长度:数据的格式。比如收到world会显示+IPD,5:world。
关闭连接：
AT+CIPCLOSE实操心得：调试TCP通信时，最好在电脑上开一个网络调试助手（比如NetAssist）作为服务端，这样你能同时看到发送和接收的内容，排查问题方便很多。另外，ESP8266默认是单连接模式，如果要同时连多个服务端，需要先设置
AT+CIPMUX=1开启多连接。
3.4 透传模式：让串口变成无线串口
透传模式是AT指令里最实用的功能之一。开启后，串口收到的任何数据都会原封不动地通过Wi-Fi发出去，Wi-Fi收到的数据也会原封不动地从串口打印出来。相当于把ESP8266变成了一个无线的串口线。
设置步骤：
AT+CIPMODE=1 AT+CIPSEND返回>后，模块进入透传模式。此时你发的所有内容都会直接发送到目标服务器。要退出透传模式，发送+++（注意不要带回车换行），模块会返回OK并退出。
注意：进入透传模式前必须先建立TCP连接。透传模式下，AT指令不再被解析，所有内容都当作数据发送。退出透传的
+++需要在一定时间内发送，且前后不能有其他数据，否则会被当作普通数据发出去。
4. 常见问题排查与避坑指南
4.1 串口无反应或全是乱码
这是最高频的问题。排查顺序如下：
- 检查TX/RX是否交叉连接。USB-TTL的TX接ESP8266的RX，RX接ESP8266的TX。接反了就没反应。
- 检查波特率。依次尝试115200、9600、74880、57600。
- 检查供电。用万用表量ESP8266的VCC和GND之间是不是稳定的3.3V。如果电压被拉低到3.0V以下，模块会不断重启。
- 检查CH_PD引脚。ESP-01的CH_PD必须接高电平（3.3V），悬空的话模块不工作。
- 检查串口工具是否被占用。Arduino IDE的串口监视器和SSCOM不能同时打开同一个串口。
4.2 AT指令返回ERROR
不同指令的ERROR原因不同，整理成速查表：
| 指令 | 常见ERROR原因 | 解决方法 |
|---|---|---|
| AT+CWJAP | 密码错误、SSID不存在、信号太弱 | 确认密码，靠近路由器，检查是否2.4G |
| AT+CIPSTART | 目标IP不可达、端口未监听、未连Wi-Fi | 先用ping测试目标，确认已连Wi-Fi |
| AT+CIPSEND | 未建立连接、发送长度超限 | 先CIPSTART，单次发送不超过2048字节 |
| AT+CWMODE | 参数不在1/2/3范围内 | 检查参数拼写 |
| AT+RST | 模块正在重启中 | 等待几秒再发指令 |
4.3 模块频繁重启
现象是串口不断打印启动信息，AT指令发不进去。原因几乎都是供电不足。ESP8266启动时电流需求大，如果电源带不动，就会反复重启。解决办法：换独立3.3V电源，加电容，或者换NodeMCU。
4.4 连上Wi-Fi但TCP连不上
先确认目标服务器的IP和端口是否正确，用电脑ping一下目标IP。如果目标在局域网内，确认电脑和ESP8266在同一网段。如果目标在公网，确认服务器防火墙是否放行了该端口。另外，有些云服务器默认只监听本地回环地址，需要改成监听0.0.0.0。
独家避坑技巧：调试AT指令时，建议把每次成功的指令序列记录下来，形成一个"最小可用指令集"。比如我的记录是：AT → AT+CWMODE=1 → AT+CWJAP="xxx","xxx" → AT+CIPSTART="TCP","xxx",xxx → AT+CIPSEND=n → 数据。下次调试新模块时直接按这个序列走一遍，能快速判断模块是否正常。
5. 从AT指令到Arduino代码的过渡思路
AT指令调通之后，你对模块的行为已经有了直观认识。这时候再写Arduino代码，心里就有底了。Arduino环境下通常用WiFiEsp库或ESP8266WiFi库。前者是通过串口发AT指令来控制ESP8266，后者是直接把代码烧录到ESP8266上运行（此时AT固件被覆盖）。
如果你用的是ESP-01配合Arduino Uno，那只能用WiFiEsp库，因为ESP-01本身没有足够的IO和USB接口来独立编程。如果你用的是NodeMCU或Wemos D1 mini，建议直接用ESP8266WiFi库，把代码烧进去，性能更好，也不用外挂单片机。
WiFiEsp库的底层其实就是帮你封装了AT指令。比如WiFi.begin(ssid, pass)对应AT+CWJAP，client.connect(ip, port)对应AT+CIPSTART。所以你在AT指令阶段积累的经验，比如错误码的含义、连接超时的处理，在写代码时完全用得上。
我个人在实际操作中的体会是：AT指令调试这一步花的时间，会在后面写代码时加倍省回来。因为你对模块的脾气已经摸透了，遇到问题能快速定位是硬件、网络还是代码的问题。最后再分享一个小技巧：把常用的AT指令存成SSCOM的快捷指令组，一键发送，调试效率能提升不少。这个内容后续还可以这样扩展：用AT指令实现HTTP请求，直接获取天气数据，或者用MQTT协议接入物联网平台，都是在这个基础上往上搭的。
