VSCode 搭配 Arduino CLI 和官方 Arduino 插件可完全替代 Arduino IDE,支持编写、编译、上传、调试及串口监视;需安装 Arduino CLI 并配置路径、选择板型与端口,上传快捷键为 Ctrl+Alt+U(Windows/Linux)或 Cmd+Alt+U(macOS)。

VSCode 搭配合适的插件,完全可以替代 Arduino IDE 完成代码编写、编译和上传,而且更轻量、更灵活、支持更好的代码导航和调试体验。
安装必要组件
要让 VSCode 支持 Arduino 开发,需要三样东西:
- Arduino CLI:官方命令行工具,负责编译和烧录。推荐从 arduino.github.io/arduino-cli 下载对应系统版本,解压后把可执行文件路径加入系统环境变量(如 Windows 的 PATH 或 macOS/Linux 的 ~/.zshrc)
- VSCode:确保已安装最新版(官网下载即可)
- Arduino 插件:在 VSCode 扩展市场搜索并安装 Arduino(由 Microsoft 官方维护,图标是蓝色电路板)
配置开发环境
首次打开一个 .ino 文件或新建 Arduino 项目时,插件会提示你选择 Arduino CLI 路径(如果没自动识别)。你也可以手动设置:
- 按 Ctrl + ,(Windows/Linux)或 Cmd + ,(macOS)打开设置
- 搜索 arduino.path,填入 arduino-cli 可执行文件的完整路径(例如
C:\arduino-cli.exe或/usr/local/bin/arduino-cli) - 再搜索 arduino.defaultBaudRate,可设为
115200(常用波特率) - 连接开发板后,在命令面板(Ctrl+Shift+P)输入 Arduino: Board Config,选择对应型号(如 Arduino Uno)和端口(如 COM3 或 /dev/cu.usbmodem14101)
编写与上传代码
新建文件夹 → 在 VSCode 中打开该文件夹 → 新建 xxx.ino 文件,写好代码(如经典的 Blink 示例)即可开始开发:
- 保存文件后,按 Ctrl+Alt+U(Windows/Linux)或 Cmd+Alt+U(macOS)直接上传(先编译再烧录)
- 按 Ctrl+Alt+R 可仅编译,不上传,适合快速验证语法和逻辑
- 串口监视器通过命令面板运行 Arduino: Open Serial Monitor,支持设置波特率、换行方式等
- 多文件项目只需把 .cpp/.h 文件放在同一文件夹下,插件会自动识别并参与编译
小技巧与常见问题
用熟之后可以进一步提升效率:
- 在项目根目录放一个
platformio.ini(如果你倾向 PlatformIO),但纯 Arduino CLI 方式无需此文件 - 上传失败常见原因:端口被占用(关闭串口助手、Arduino IDE 等)、驱动未装(CH340/CP210x 芯片需单独装驱动)、板子型号或端口选错
- 插件支持代码补全、函数跳转、错误实时提示,写库或复杂项目时比原生 IDE 更顺手
- 想启用自动保存+自动上传?可在设置中开启 arduino.autoUploadOnSave(谨慎开启,避免误操作烧录)
基本上就这些。不用装臃肿的 IDE,也能高效玩转 Arduino —— 关键是 CLI 配对正确、端口选准、板型设对。











