VS Code需配合Arduino官方扩展和arduino-cli才能完成Arduino开发全流程。必须手动安装配置arduino-cli、初始化配置、正确选择板型与串口，并排查驱动及连接问题。
VS Code 本身不原生支持 Arduino 开发，必须通过 Arduino Extension（由 Microsoft 官方维护）+ arduino-cli 底层工具链才能完成编写、验证、上传全流程。直接装插件不配 CLI，会卡在“找不到端口”或“Verify failed: no board selected”这类错误。
安装 arduino-cli 并让 VS Code 找到它
VS Code 的 Arduino 插件默认依赖系统 PATH 中的 arduino-cli 可执行文件，不是图形 IDE 那套后台服务。Windows/macOS/Linux 都要手动下载并配置路径。
- 去 GitHub releases 页面 下载对应系统的
arduino-cli（如arduino-cli_0.38.2_Windows_64bit.zip），解压后把arduino-cli.exe（或 macOS/Linux 的可执行文件）所在目录加进系统 PATH - 终端运行
arduino-cli version能输出版本号才算成功；否则 VS Code 插件会提示 “arduino-clinot found” - 首次运行需初始化：
arduino-cli config init，它会生成arduino-cli.yaml，之后插件才能读取板卡和库配置
用 Arduino 插件新建项目并选择正确板型
插件创建的项目结构和传统 Arduino IDE 不同：它生成的是带 platformio.ini 或 arduino.json 的纯代码目录，没有隐藏的临时构建文件夹。选错板型会导致编译失败或上传后无响应。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入 “Arduino: Initialize” 创建新项目 - 在弹出的板型列表中，不要只搜关键词如 “uno” —— 实际要选完整标识，例如
Arduino Uno对应arduino:avr:uno，而Arduino Nano Every是arduino:megaavr:nona4809 - 如果列表里没有你的开发板（比如 ESP32 或 RP2040），先在终端运行
arduino-cli core install esp32:esp32或arduino-cli core install raspberry-silicon:rp2040，再重开 VS Code
上传前必须手动选择串口和端口速度
不像 Arduino IDE 自动枚举 COM/USB 设备，VS Code 插件默认不自动刷新串口列表，拔插设备后需手动触发，否则上传时显示 “No serial port available” 或上传成功但板子没反应。
家电公司网站源码是一个以米拓为核心进行开发的家电商城网站模板，程序采用metinfo5.3.9 UTF8进行编码，软件包含完整栏目与数据。安装方法：解压上传到空间，访问域名进行安装，安装好后，到后台-安全与效率-数据备份还原，恢复好数据后到设置-基本信息和外观-电脑把网站名称什么的改为自己的即可。默认后台账号：admin 密码：132456注意：如本地测试中127.0.0.1无法正常使用，请换成l
- 连接开发板后，按
Ctrl+Shift+P输入 “Arduino: Select Serial Port”，从下拉菜单选对的端口（Windows 是COM3，macOS 是/dev/cu.usbserial-XXXX，Linux 是/dev/ttyUSB0） - 某些板子（如 CH340 芯片的 Nano 兼容版）需要额外设置上传速率：在项目根目录建
arduino.json，写入{"upload": {"speed": 115200}} - 上传命令是
Ctrl+Shift+P→ “Arduino: Upload”，不是 Ctrl+S 保存就自动上传 —— 这点新手最容易误以为“写完就能跑”
常见上传失败原因和快速排查项
报错信息往往藏在 VS Code 右下角通知或输出面板（Output → Arduino）里，而不是终端窗口。很多问题其实和代码无关，而是环境链路断了。
-
Failed to execute script arduino-cli：PATH 没配好，或arduino-cli权限不足（macOS/Linux 需chmod +x） -
Board arduino:avr:uno not found：core 没装全，运行arduino-cli core list看是否含 avr，没有就arduino-cli core update && arduino-cli core install arduino:avr - 上传时进度条卡住几秒后失败：USB 驱动异常（尤其 Windows 上 CH340 需重装驱动）、USB 线仅充电不传数据、板子未进入 bootloader 模式（Nano 类需手动按复位键时机配合上传）
- 上传成功但 LED 不闪：检查
void setup()里是否漏了pinMode(LED_BUILTIN, OUTPUT)，或LED_BUILTIN定义不匹配（某些兼容板需改成13）
真正麻烦的从来不是写代码，而是让 VS Code、arduino-cli、驱动、物理连接这四层之间不互相“假装在线”。每次换电脑或换线，都建议从 arduino-cli version 和 arduino-cli board list 这两个命令开始验证。
