在VSCode中使用PlatformIO进行嵌入式开发入门

PlatformIO在vscode中简化嵌入式开发，依赖python 3.7+和git，安装扩展后可快速创建ESP32项目，通过platformio.ini配置环境，支持一键编译、上传和串口监控。

在 VSCode 中用 PlatformIO 做嵌入式开发，其实比想象中简单——它把环境搭建、库管理、编译烧录这些繁琐事全包了，你只需要专注写代码。

安装前先装好基础环境

PlatformIO 本质是 VSCode 的一个扩展，但它依赖 Python（3.7+）和 Git。别跳过这步，否则后续新建项目会报错。

• 确认已安装 Python：终端里运行 python –version 或 python3 –version，显示 3.7 以上即可
• Git 推荐装完整版（带命令行工具），PlatformIO 有时会自动 clone 库
• 打开 VSCode，搜索安装 PlatformIO ide 扩展（官方出品，图标是蓝底白“P”）

新建一个 ESP32 项目试试手

选个常见板子练起来最直观。以 ESP32-DevKitC 为例：

• 按 Ctrl+Shift+P（Win/linux）或 Cmd+Shift+P（Mac），输入 PlatformIO: New Project
• 填项目名，选择开发板（搜 esp32dev），框架选 Arduino（上手快）或 ESP-IDF（更底层）
• 点创建，PlatformIO 自动初始化文件夹结构，生成 platformio.ini 配置文件

生成的 src/main.cpp 就是主程序入口，里面默认有 Arduino 风格的 setup() 和 loop()。

理解 platformio.ini 这个关键配置文件

它相当于项目的“说明书”，控制编译目标、依赖库、上传端口等。新项目生成的 ini 文件类似这样：

JS超酷图片翻动展示效果

js超酷图片翻动展示效果，根据鼠标进出图片的方向来控制图片进出的方式，效果超炫，兼容主流浏览器。 使用方法： 1、head区域引用文件 lrtk.css，animation.css 2、在文件中加入!– 代码 开始 –!– 代码 结束 –区域代码 3、js代码需要在html代码之后载入public.js，main.js 4、如需修改图片尺寸，直接在lrtk.css第10行修改即可

120

查看详情

[env:esp32dev] platform = espressif32 board = esp32dev framework = arduino upload_port = /dev/ttyUSB0  ; Linux/Mac，windows 是 COM3 这类 monitor_port = /dev/ttyUSB0 monitor_speed = 115200

常用改法：

• 换板子？改 board 字段（如 nodemcu-32s）
• 加库？在 lib_deps 下写一行，比如 Arduinojson 或 https://github.com/adafruit/Adafruit_SSD1306
• 查不到串口？插好开发板后，在终端运行 pio device list 看识别到哪个端口

编译、上传、串口监控三步到位

不用切终端，VSCode 底部状态栏就有快捷操作：

• 点击左下角 Build（锤子图标）→ 编译整个项目，成功后提示 “Success”
• 点 Upload（向上箭头）→ 自动编译（如有修改）+ 烧录进板子
• 点 Serial Monitor（终端图标）→ 弹出串口监视器，波特率自动匹配 monitor_speed

如果上传失败，大概率是端口没选对、没按住 BOOT 键（某些板子需要手动进入下载模式）、或驱动没装（CH340/CP210x 芯片需单独装驱动）。

基本上就这些。PlatformIO 的优势不在多炫，而在稳定、统一、可复现——同一个 platformio.ini，换台电脑也能分分钟拉起一模一样的开发环境。