VSCode 搭配 PlatformIO 插件可构建高度集成、跨平台且开源免费的嵌入式开发环境；需依次完成安装配置、项目初始化、串口烧录设置、终端与串口监视器启用、依赖库管理五步。
如果您希望在嵌入式开发中获得高度集成、跨平台且开源免费的开发体验，vscode 搭配 platformio 插件可提供完整的工具链支持。以下是实现该开发环境配置与使用的关键步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 VSCode 与 PlatformIO 插件
此步骤旨在为 VSCode 添加 PlatformIO 的核心功能，使其具备项目创建、编译、烧录及调试能力。PlatformIO 是一个独立于厂商的嵌入式生态系统，其插件将自动集成 CLI 工具、库管理器和串口监视器。
1、访问 code.visualstudio.com 下载并安装最新版 VSCode。
2、启动 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X），在搜索框中输入 PlatformIO IDE。
3、在搜索结果中找到官方发布的 PlatformIO IDE 扩展（发布者为 PlatformIO），点击“安装”按钮。
4、安装完成后，重启 VSCode 以激活全部功能。
二、初始化 PlatformIO 项目
该操作将生成符合 PlatformIO 标准结构的工程目录，包含 platformio.ini 配置文件、src/ 主源码目录和 lib/ 第三方库目录，确保构建系统能正确识别目标芯片与框架。
1、在 VSCode 中按下 Cmd+Shift+P，调出命令面板。
2、输入 PlatformIO: New Project 并回车。
3、在弹出的窗口中，为项目指定名称和保存路径。
4、从设备列表中选择目标开发板，例如 ESP32 DevKitC；再选择开发框架，如 Arduino 或 Espressif IoT Development Framework (ESP-IDF)。
三、配置串口与烧录参数
此步骤确保 PlatformIO 能准确识别连接的物理设备，并在编译后将固件正确写入目标芯片。串口号、上传速率与分区方案需与硬件实际状态严格匹配。
1、使用 USB 数据线将开发板接入 Mac，打开终端执行 ls /dev/tty.* 查看当前可用串口设备，记下类似 /dev/tty.usbserial-1420 的路径。
2、在项目根目录下的 platformio.ini 文件中，于 [env:your_env_name] 区块下添加或修改以下行：
睿拓智能网站系统-网上商城1.0免费版软件大小:5M运行环境：asp+access本版本是永州睿拓信息专为电子商务入门级用户开发的网上电子商城系统，拥有产品发布，新闻发布，在线下单等全部功能，并且正式商用用户可在线提供多个模板更换，可实现一般网店交易所有功能，是中小企业和个人开展个人独立电子商务商城最佳的选择，以下为详细功能介绍：1.最新产品-提供最新产品发布管理修改，和最新产品订单查看2.推荐产
upload_port = /dev/tty.usbserial-1420
upload_speed = 921600
3、若使用 ESP32 并需自定义分区表，在同一区块中加入：board_build.partitions = partitions.csv，并将对应 CSV 文件置于项目根目录。
四、启用 PlatformIO 终端与串口监视器
PlatformIO 内置终端可直接调用其 CLI，避免切换外部终端；串口监视器则用于实时查看设备输出日志，是调试通信与传感器数据的关键界面。
1、在 VSCode 底部状态栏点击 PLATFORMIO 标签，选择“Terminal”打开集成终端。
2、在终端中输入 pio device list 验证开发板是否被识别。
3、点击左侧边栏的 PlatformIO Home 图标，进入主页后点击“Serial Monitor”按钮。
4、在弹出窗口中确认波特率与项目中 monitor_speed 设置一致，例如 115200，然后点击“Start”。
五、管理依赖库与版本控制
PlatformIO 提供统一的库管理机制，支持通过名称、URL 或本地路径引入第三方代码，所有依赖均记录在 lib_deps 字段中，便于团队协作与 CI/CD 流水线复现环境。
1、在 platformio.ini 的环境区块内添加 lib_deps 配置项。
2、添加 Arduino 官方库示例：lib_deps = ArduinoJson@6.21.5。
3、添加 GitHub 仓库示例：lib_deps = https://github.com/bblanchon/ArduinoJson.git#6.x。
4、添加本地库路径示例：lib_deps = ../my_custom_library。
