需配置VSCode、PlatformIO插件、ARM工具链、新建项目、连接烧录及串口监控；macOS下用Homebrew安装Python和arm-none-eabi-gcc，通过PlatformIO命令完成初始化、上传与日志监视。
如果您希望在本地环境中搭建嵌入式开发环境，但尚未配置好集成工具链，则可能是由于开发平台与编辑器未正确协同工作。以下是完成该配置的具体步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装VSCode与PlatformIO插件
VSCode作为轻量级但高度可扩展的代码编辑器，需通过官方插件市场引入PlatformIO核心支持，从而获得项目生成、编译、烧录及串口监控等完整嵌入式功能。
1、访问code.visualstudio.com下载并安装最新版VSCode。
2、启动VSCode，点击左侧活动栏的扩展图标（或按Cmd+Shift+X）。
3、在搜索框中输入PlatformIO IDE，选择由PlatformIO开发团队发布的官方插件。
4、点击“安装”，等待插件及其依赖（如Python环境检查器、C/C++工具链提示器）自动部署完成。
二、配置PlatformIO底层工具链
PlatformIO依赖Python运行时及一系列交叉编译工具（如arm-none-eabi-gcc），其安装方式因操作系统而异；macOS下推荐使用Homebrew统一管理，避免权限与路径冲突。
1、打开终端，执行brew install python确保Python 3.9及以上版本可用。
2、运行brew install arm-none-eabi-gcc安装ARM Cortex-M系列主流交叉编译器。
3、在VSCode命令面板（Cmd+Shift+P）中输入并执行PlatformIO: Initialize Project，触发自动检测与补全工具链路径。
三、创建并初始化嵌入式项目
PlatformIO项目结构严格遵循约定目录格式，包含platformio.ini配置文件、src源码目录及lib依赖目录，初始化过程将自动生成这些关键组件。
1、按下Cmd+Shift+P，输入PlatformIO: New Project并回车。
2、在弹出窗口中为项目命名，例如led-blink-esp32。
3、从开发板列表中选择ESP32 DevKitC（或其他已连接的实际硬件型号）。
4、确认框架选择为Arduino或ESP-IDF，点击“Finish”生成完整项目骨架。
四、连接硬件并上传固件
上传前需确认开发板已通过USB正确连接至主机，并被系统识别为串行设备；macOS通常将其挂载为/dev/cu.usbserial-XXXX形式的端口。
1、使用USB线连接ESP32开发板，观察板载LED是否短暂闪烁以确认供电正常。
2、在VSCode底部状态栏点击端口标识（如/dev/cu.usbserial-1420），若未显示则点击右侧箭头手动选择。
3、按下Cmd+Shift+P，输入并执行PlatformIO: Upload，编译完成后自动进入烧录流程。
五、监控串口输出日志
嵌入式程序常通过UART打印调试信息，PlatformIO内置串口监视器可实时捕获这些数据，波特率必须与代码中Serial.begin()参数严格一致。
1、确保main.cpp中已调用Serial.begin(115200)且无语法错误。
2、按下Cmd+Shift+P，输入并执行PlatformIO: Serial Monitor。
3、在右上角下拉菜单中确认波特率设置为115200，点击连接按钮启动监听。
