用 VSCode 写 Arduino 代码并上传固件更轻快灵活,需安装官方 Arduino 和 C/C++ 插件,首次打开 .ino 文件自动配置 CLI 与核心库,新建项目后编写代码、选择板型端口,按 Ctrl+Alt+U 即可一键编译上传。

用 VSCode 写 Arduino 代码并上传固件,比用官方 IDE 更轻快、更灵活,关键是配置好插件和工具链就行。
安装必要插件和工具
先装好 VSCode(官网下载最新版),然后在扩展市场里搜装两个核心插件:
- Arduino(由 Microsoft 官方维护,图标是 A+电路板)
- C/C++(提供语法高亮、智能提示和调试支持)
插件装完后重启 VSCode。接着让插件自动帮你装 Arduino CLI 和相关核心库——首次打开 .ino 文件时,它会弹窗提示“下载 Arduino CLI”和“安装 arduino:avr 核心”,点“是”即可。如果没弹,可手动按 Ctrl+Shift+P 打开命令面板,输入 Arduino: Initialize 并运行。
新建项目并写代码
按 Ctrl+Shift+P,输入 Arduino: New Sketch,选保存位置,输入名字(比如 blink),回车就生成一个带 setup() 和 loop() 的 .ino 文件。
写个最简示例验证环境:
void setup() {
pinMode(LED_BUILTIN, OUTPUT);
}
void loop() {
digitalWrite(LED_BUILTIN, HIGH);
delay(500);
digitalWrite(LED_BUILTIN, LOW);
delay(500);
}
保存文件(Ctrl+S),VSCode 左下角会显示当前板子型号和端口(如 “Arduino Uno on COM3”)。如果没显示,点左下角区域手动选择板型和串口。
编译与上传一键完成
把开发板用 USB 线连电脑,确保驱动已安装(Windows 可能需手动装 CH340 或 CP210x 驱动)。
- 按 Ctrl+Alt+U:编译 + 上传(默认快捷键)
- 按 Ctrl+Alt+R:仅编译(检查语法和逻辑错误)
上传成功后,板载 LED 会以 500ms 频率闪烁。终端窗口(底部面板)会显示详细日志,包括编译大小、上传进度和是否成功。
常见小问题快速处理
如果上传失败,先看终端报错关键词:
- “Permission denied” 或 “Access is denied” → 检查串口是否被其他程序占用(比如串口助手、另一个 VSCode 窗口)
- “No device found” → 确认开发板已上电、USB 连接正常,再点左下角重新选一次端口
- “Board not found” → 在命令面板运行 Arduino: Board Config,确认选的是正确型号(如 Arduino Uno,不是 Nano 或 Mega)
- 代码改了但没反应 → 确保你修改的是当前打开的 .ino 文件,且已保存(VSCode 默认不自动保存)
基本上就这些。不用折腾路径、不用手动调参数,插件把底层细节都包圆了。











