需安装VSCode、PlatformIO IDE扩展,初始化ESP32项目,配置串口权限,编写DHT22传感器代码并上传,最后用Serial Monitor监控115200波特率输出。

如果您希望使用 VSCode 进行 Arduino 或 PlatformIO 项目的开发,但尚未配置好开发环境,则可能是由于扩展未安装、工具链未初始化或串口权限未设置。以下是完成物联网开发入门配置的具体步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装 VSCode 及必要扩展
VSCode 本身不原生支持 Arduino 编程,需通过扩展引入编译、上传与调试能力。PlatformIO IDE 扩展是目前最主流的嵌入式开发集成方案,它内置了多平台工具链和项目管理器。
1、访问 code.visualstudio.com 下载并安装 VSCode 应用程序。
2、启动 VSCode,点击左侧活动栏的扩展图标(或按 Cmd+Shift+X)。
3、在搜索框中输入 PlatformIO IDE,找到官方发布的扩展(作者为 PlatformIO),点击“安装”。
4、安装完成后,重启 VSCode 使扩展完全加载。
二、初始化 PlatformIO 项目
PlatformIO 使用基于 C/C++ 的项目结构,自动管理库依赖、板卡定义与构建参数。初始化项目会生成 platformio.ini 配置文件及标准源码目录。
1、点击 VSCode 左侧活动栏底部的 PlatformIO 图标(火箭形状)。
2、在弹出侧边栏中选择 New Project。
3、在项目名称栏输入 iot-sensor-node,框架选择 Arduino,开发板选择 ESP32 DevKitC(适用于常见 WiFi 物联网节点)。
4、点击“Finish”,等待项目结构自动生成完成。
三、配置串口与设备权限
上传代码至物理设备前,必须确保系统能识别 USB 转串口芯片,并授予当前用户读写权限,否则会出现 Permission denied 错误。
1、将 ESP32 开发板通过 USB 线连接至 MacBook Air。
2、打开终端,执行 ls /dev/tty.*,确认出现类似 /dev/tty.usbserial-1420 的设备节点。
3、若提示权限拒绝,在终端中执行 sudo chmod 666 /dev/tty.usbserial-1420(请将设备名替换为实际查到的名称)。
4、返回 VSCode,点击右下角状态栏中的串口号(如 /dev/tty.usbserial-1420),确认已正确识别。
四、编写并上传基础传感器示例
物联网项目通常从采集温湿度等环境数据开始。DHT22 是常用数字传感器,其驱动已包含在 PlatformIO 默认库中,无需手动下载。
1、在项目 src 目录下打开 main.cpp 文件,删除默认内容。
2、粘贴以下代码段:
#include <Arduino.h>\n#include "DHT.h"\n\n#define DHTPIN 4\n#define DHTTYPE DHT22\nDHT dht(DHTPIN, DHTTYPE);\n\nvoid setup() {\n Serial.begin(115200);\n dht.begin();\n}\n\nvoid loop() {\n float h = dht.readHumidity();\n float t = dht.readTemperature();\n if (!isnan(h) && !isnan(t)) {\n Serial.print("H: "); Serial.print(h); Serial.print("% T: "); Serial.println(t);\n }\n delay(2000);\n}
3、保存文件后,点击 PlatformIO 工具栏中的 Build 按钮(锤子图标)验证编译是否通过。
4、编译成功后,点击 Upload(纸飞机图标)将固件烧录至开发板。
五、监控串口输出与调试
上传完成后,设备会立即运行代码并周期性发送传感器数据。PlatformIO 内置串口监视器可实时捕获这些输出,用于验证硬件连接与逻辑正确性。
1、点击 VSCode 左侧 PlatformIO 图标,展开“Serial Monitor”项。
2、点击右侧的 Open Serial Monitor 按钮。
3、在弹出窗口中确认波特率设置为 115200(与代码中 Serial.begin 参数一致)。
4、观察窗口中是否持续打印出类似 H: 45.2% T: 23.8 的数值行。










