我们的太空1. 环境准备与工程创建
在开始使用VS Code和ESP-IDF开发ESP32项目之前，我们需要确保开发环境已经正确配置。ESP-IDF是乐鑫官方提供的物联网开发框架，支持ESP32、ESP32-S等系列芯片的开发。
1.1 安装必要工具链
首先需要安装以下组件：
- Visual Studio Code（建议最新稳定版）
- ESP-IDF插件（通过VS Code扩展市场安装）
- 乐鑫官方工具链（可通过ESP-IDF插件自动安装）
安装完成后，在VS Code中按下Ctrl+Shift+P打开命令面板，输入"ESP-IDF: Configure ESP-IDF extension"进行初始配置。这里建议选择"Express"安装方式，它会自动下载所需的所有工具链和Python依赖。
注意：安装过程中需要保持网络畅通，因为需要下载约1GB的工具链文件。如果遇到下载失败的情况，可以尝试切换下载镜像源。
1.2 创建新工程
在VS Code中创建ESP-IDF工程的步骤如下：
- 打开命令面板（Ctrl+Shift+P）
- 输入"ESP-IDF: New Project"并执行
- 在弹出的对话框中填写项目信息：
- 项目名称（如"my_first_esp32_project"）
- 项目存储路径（建议使用不含中文和空格的路径）
- 目标芯片类型（ESP32、ESP32-S2/S3等）
- 下载方式（UART、JTAG等）
- 串口号（根据实际连接的COM端口选择）
- ESP-IDF组件路径（通常自动填充）
创建完成后，VS Code会自动生成一个包含基本框架的项目目录。这个模板项目已经包含了必要的构建配置和main文件夹，其中app_main()函数是程序的入口点。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 工程结构与配置解析
2.1 项目目录结构
一个典型的ESP-IDF项目包含以下关键目录和文件：
code复制my_project/
├── CMakeLists.txt # 项目级构建配置
├── sdkconfig # 项目配置存储文件
├── main/
│ ├── CMakeLists.txt # 主组件构建配置
│ └──