1. ‌基础环境安装‌

• 安装VSCode和Arduino IDE（建议1.8.x版本）
• 在VSCode扩展商店安装官方Arduino插件或PlatformIO IDE插件

1. ‌开发板支持配置‌

• 在Arduino IDE中添加开发板管理器网址：

  https://www.arduino.cn/package_esp32_dev_index.json
  http://arduino.esp8266.com/stable/package_esp8266com_index.json

  通过"工具>开发板>开发板管理器"安装对应库

1. ‌VSCode具体配置‌

• 设置Arduino路径：文件>首选项>设置，在Arduino扩展配置中添加Arduino安装路径
• 配置串口和开发板类型：通过右下角状态栏选择端口和开发板型号
• 对于PlatformIO方案：新建项目时选择对应框架(Arduino)和开发板(ESP32/ESP8266)

1. ‌项目开发流程‌

• 创建项目 : 点击PlatformIO图标‌  -> Platforms
• 切换到Projects,点击Create New Project
• 录入项目名称,版型,以及使用框架
• 等待5到30分钟不等
• 编译快捷键：Ctrl+Alt+R，上传快捷键：Ctrl+Alt+U
• 串口监视器可通过右下角插头图标开启，需保持波特率与代码一致

1. ‌常见问题解决‌

• 上传无进度：检查arduino.json中的output配置和串口占用
• 库文件缺失：通过Arduino-cli配置库路径或手动添加
• PlatformIO首次建工程较慢：需自动下载芯片支持包
• 导入原Arduion IDE项目没有PlatformIO的platformio.ini配置文件,需要执行以下代码生成

  pip install -U platformio
  pio project init --board=esp32dev

• 执行pio project init --board=esp32dev 但报错无法将“pio”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后再试一次:

  pip uninstall platformio
  pip install -U platformio

• pip install -U platformio 完成后,执行pio --version 报'pio' 不是内部或外部命令，也不是可运行的程序：系统安装多版本python造成的冲突
  1. 右键"此电脑" → 属性 → 高级系统设置 → 环境变量
  2. 在"系统变量"中找到Path变量 → 编辑 → 新建
  3. 添加路径：C:\Users\XXX\AppData\Roaming\Python\Python313\Scripts
  4. 同时建议添加Python主目录路径（如C:\Users\XXX\AppData\Roaming\Python\Python313）
• 执行pio project init --board=esp32dev 时报如下

   'C:\Program' 不是内部或外部命令，也不是可运行的程序或批处理文件。CalledProcessError: Traceback (most recent call last):
    File "C:\Users\XXX\AppData\Roaming\Python\Python313\site-packages\platformio\__main__.py", line 103, in main
      cli()  # pylint: disable=no-value-for-parameter: 

  1. 过高版本pyhton不兼容pio指定,卸载并安装.python3.8-3.10版本
• 执行pio project init --board=esp32dev 时报如下错误

Traceback (most recent call last):
  File "C:\Users\Neo\.platformio\packages\tool-esptoolpy\esptool.py", line 41, in <module>
    import esptool
  File "C:\Users\Neo\.platformio\packages\tool-esptoolpy\esptool\__init__.py", line 42, in <module>
    from esptool.bin_image import intel_hex_to_bin
  File "C:\Users\Neo\.platformio\packages\tool-esptoolpy\esptool\bin_image.py", line 16, in <module>
    from intelhex import HexRecordError, IntelHex
ModuleNotFoundError: No module named 'intelhex'
*** [.pio\build\esp32dev\bootloader.bin] Error 1
*** [.pio\build\esp32dev\FrameworkArduino\esp32-hal-dac.c.o] Error 3
*** [.pio\build\esp32dev\FrameworkArduino\base64.cpp.o] Error 3

        解决方法: 在终端运行以下命令并删除.C:\Users\XXX\.platformio 文件夹

pip install intelhex

建议初学者优先使用Arduino插件方案，专业开发可选择PlatformIO获得更完整的工具链支持。两种方案均支持代码补全、调试和串口监控等核心功能。