讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

VSCode的Arduino for Visual Studio Code:嵌入式开发终极指南

冬枫大大_4838

冬枫大大_4838

发布时间:2026-01-06 08:22:43

|

1137人浏览过

|

来源于php中文网

原创

需先安装Arduino CLI并配置核心工具链,再在VSCode中安装官方扩展、指定CLI路径、设置板卡与串口,接着通过命令初始化项目,最后授权USB驱动并上传代码及启用串口监视器。

vscode的arduino for visual studio code:嵌入式开发终极指南

如果您希望在 Visual Studio Code 中高效进行 Arduino 嵌入式开发,但尚未配置好官方扩展环境,则可能面临板卡识别失败、串口无法通信、代码无法上传等基础问题。以下是完成 Arduino for VSCode 全流程配置与调试的关键步骤:

本文运行环境:MacBook Air M2,macOS Sequoia。

一、安装 Arduino CLI 与核心工具链

Arduino for VSCode 不依赖 Arduino IDE 图形界面,而是通过命令行工具链(Arduino CLI)实现编译与烧录。必须先独立安装 CLI 并注册常用开发板核心,否则后续所有操作将因缺少编译器或板定义而中断。

1、访问 https://github.com/arduino/arduino-cli/releases 下载对应 macOS 的最新 arduino-cli 二进制文件。

2、将下载的 arduino-cli 文件移至 /usr/local/bin/ 目录,并执行 chmod +x /usr/local/bin/arduino-cli 赋予可执行权限。

3、在终端中运行 arduino-cli config init 初始化配置文件,生成默认 ~/.arduino-cli.yaml。

4、执行 arduino-cli core update-index 更新板卡索引。

5、安装 Arduino AVR 核心:运行 arduino-cli core install arduino:avr;如需 ESP32 支持,额外执行 arduino-cli core install esp32:esp32。

二、配置 VSCode 扩展与工作区设置

VSCode 本身不内置 Arduino 支持,需启用官方扩展并手动指定 CLI 路径与开发板参数。若未正确绑定 CLI 可执行路径,扩展将始终显示“Arduino CLI not found”错误提示。

1、在 VSCode 扩展市场中搜索并安装 Arduino 扩展(发布者为 Microsoft)。

2、打开一个空文件夹作为 Arduino 工作区,点击左下角齿轮图标选择 Settings (UI),搜索 arduino.path,将其值设为 /usr/local/bin/arduino-cli。

3、在工作区根目录创建 .vscode/settings.json 文件,写入以下内容:

{"arduino.defaultBoard": "arduino:avr:uno", "arduino.defaultPort": "/dev/cu.usbmodem14301"}

4、重启 VSCode,确保状态栏右下角显示已识别的板型(如 UNO)与串口号。

三、创建与验证第一个 .ino 项目

VSCode 不提供图形化新建项目向导,必须通过命令面板触发 CLI 初始化流程。跳过该步骤直接新建 .ino 文件将导致编译时无法解析 #include 或找不到 main 函数入口。

GitHub一键发布助手(专业版)
GitHub一键发布助手(专业版)

本地项目发布到GitHub的完整工作流助手。自动执行:安全检查(.gitignore、排除敏感.env/凭据文件)、补齐开源文件(LICENSE、.gitignore)、git init/commit/branch、创建远程仓库、首次推送、可选打tag。支持git filter-repo历史敏感信息重写、force push、tag管理。Windows下走Credential Manager自动认证。触发词:"发布到GitHub"、"上传到github"、"

下载

1、按下 Cmd+Shift+P 打开命令面板,输入并选择 Arduino: Initialize...。

2、在弹出的选项中依次选择目标板卡(如 Arduino Uno)、Sketch 名称(如 Blink)和保存位置。

3、VSCode 将自动生成包含 Blink.ino 与 platformio.ini(若启用了 PlatformIO 模式)的结构化项目目录。

4、打开 Blink.ino,确认首行存在 #include ,且 setup() 与 loop() 函数完整。

四、上传代码到物理开发板

上传失败常源于串口权限不足、驱动缺失或板卡复位时机不当。macOS Sequoia 默认禁用第三方 USB 驱动加载,需手动授权,否则上传过程会在 “Connecting to programmer…” 步骤无限挂起。

1、将 Arduino Uno 板通过 USB 线连接 Mac,观察系统报告是否识别为 cu.usbmodem* 设备(可在终端运行 ls /dev/cu.* 查看)。

2、如未列出设备,前往 系统设置 → 隐私与安全性 → 安全性,点击 允许 按钮以启用 CH340 或 CP210x 驱动。

3、在 VSCode 编辑器中打开 Blink.ino,点击右下角板卡标识旁的 Upload 图标(向上箭头)。

4、上传成功后,终端输出窗口将显示 Sketch uses 928 bytes (2%) of program storage space...,Uno 板载 LED 开始闪烁。

五、启用串口监视器实时调试

串口监视器是嵌入式调试的核心工具,用于接收传感器数据或打印调试信息。VSCode 内置监视器不支持自动换行与十六进制显示,且默认波特率与代码中 Serial.begin() 不一致时将输出乱码。

1、在代码中确保已调用 Serial.begin(9600)(或其它明确波特率),并在 loop() 中添加 Serial.println("Hello");。

2、点击 VSCode 左下角状态栏中的 Select Serial Port,选择与开发板匹配的 /dev/cu.usbmodem* 项。

3、再次点击状态栏,选择 Open Serial Monitor,右侧将弹出终端窗口。

4、在监视器输入框中输入字符后按回车,可向开发板发送指令;勾选 Auto Scroll 和 Show Timestamp 提升可读性。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2375

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3922

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1296

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4559

2025.09.10

github中文官网入口 github中文版官网网页进入
github中文官网入口 github中文版官网网页进入

github中文官网入口https://docs.github.com/zh/get-started,GitHub 是一种基于云的平台,可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中,你可以: “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。

8945

2026.01.21

GitHub官网入口版本汇总
GitHub官网入口版本汇总

本专题整合了GitHub入口版本地址汇总,阅读专题下面的文章了解更多详细内容。

1038

2026.04.02

vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

1655

2023.06.30

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3612

2023.07.21

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn