本文档为ESP32-C3硬件开发提供快速入门指南介绍如何搭建软件环境和使用ESP-IDF框架。内容包括硬件准备开发板、USB线等、软件安装工具链、构建工具等、工作流程环境搭建和项目开发两个阶段以及多种开发方式IDE或命令行。文档还说明了如何安装和卸载ESP-IDF并提供了相关操作系统的具体说明链接。ESP32-C3芯片支持Wi-Fi、蓝牙等功能适用于多种物联网应用场景。快速入门[English]本文档旨在指导用户搭建 ESP32-C3 硬件开发的软件环境通过一个简单的示例展示如何使用 ESP-IDF (Espressif IoT Development Framework) 配置菜单并编译、下载固件至 ESP32-C3 开发板等步骤。备注这是 ESP-IDF master 分支最新版本的文档该版本在持续开发中。还有 稳定版本 的文档以及其他版本的文档 ESP-IDF 版本简介 供参考。概述ESP32-C3 SoC 芯片支持以下功能2.4 GHz Wi-Fi低功耗蓝牙高性能 32 位 RISC-V 单核处理器多种外设内置安全硬件ESP32-C3 采用 40 nm 工艺制成具有最佳的功耗性能、射频性能、安全性和可靠性适用于各种应用场景和不同功耗需求。乐鑫为用户提供完整的软、硬件资源进行 ESP32-C3 硬件设备的开发。其中乐鑫的软件开发环境 ESP-IDF 旨在协助用户快速开发物联网 (IoT) 应用可满足用户对 Wi-Fi、蓝牙、低功耗等方面的要求。准备工作硬件一款ESP32-C3开发板USB 数据线A 转 Micro-B电脑Windows、Linux 或 macOS备注目前一些开发板使用的是 USB Type C 接口。请确保使用合适的数据线来连接开发板以下是 ESP32-C3 官方开发板点击链接可了解更多硬件信息。ESP32-C3-DevKitC-02ESP32-C3-DevKitM-1ESP32-C3-LCDkit软件如需在ESP32-C3上使用 ESP-IDF请安装以下软件设置工具链用于编译 ESP32-C3 代码编译构建工具—— CMake 和 Ninja 编译构建工具用于编译 ESP32-C3应用程序获取ESP-IDF软件开发框架。该框架已经基本包含 ESP32-C3 使用的 API软件库和源代码和运行工具链的脚本工作流程概览ESP-IDF 的入门流程分为两个主要阶段搭建环境—— 安装前置依赖和 ESP-IDF参见 安装开发—— 创建、配置、编译、烧录项目并监视输出参见 构建首个项目如果不确定从哪里开始请参见 工作流程概览查看完整工作流程图示。安装请使用 ESP-IDF 安装管理器 (EIM) 来安装 ESP-IDF、构建工具和相关工具链该管理器支持多种操作系统。EIM 提供两种安装方式图形用户界面 (GUI)用户友好适合大多数用户。命令行界面 (CLI)适用于 CI/CD 流水线和自动化安装。在 Windows 上安装 ESP-IDF 及工具链在 Linux 上安装 ESP-IDF 及工具链在 macOS 上安装 ESP-IDF 及工具链构建首个项目安装 ESP-IDF 后您可选择在集成开发环境 (IDE) 中或通过命令行来构建首个项目。在 IDE 中构建通过 EIM 安装的 ESP-IDF 版本可搭配以下 IDE 使用获得图形化开发体验基于 Eclipse CDT 的 Espressif-IDE该 IDE 已集成 IDF Eclipse 插件、必备 Eclipse CDT 插件和其他 Eclipse 平台插件可支持 ESP-IDF 应用的开发和构建。安装 ESP-IDF 拓展 的 Visual Studio Code通过安装拓展您可直接在 Visual Studio Code 中开发、构建、烧录和监视 ESP-IDF 应用程序。关于 IDE 的具体配置与使用方法请参阅上述对应的文档。通过命令行构建如果使用命令行构建项目、构建、烧录至 ESP32-C3、监视设备输出请根据您的操作系统参考以下说明在 Windows 上通过命令行构建项目在 Linux 或 macOS 上通过命令行构建项目备注如果尚未安装 ESP-IDF请跳转至 安装按照说明先安装所有必需的软件。卸载 ESP-IDF如需卸载通过 EIM 安装的 ESP-IDF 及相关工具可使用图形用户界面 (GUI) 或命令行界面 (CLI) 两种方式。使用 EIM GUI 卸载 ESP-IDF使用 EIM CLI 卸载 ESP-IDF