手把手教你配置 CLion 开发 ESP32：从零搭建高效 C/C++ 开发环境

1. 前言

ESP32 是一款功能强大的 Wi-Fi & 蓝牙双模物联网芯片，广泛应用于智能家居、可穿戴设备和工业控制等领域。虽然官方推荐使用基于 Eclipse 的 ESP-IDF 插件进行开发，但对于习惯 JetBrains 系列 IDE（如 CLion）的开发者来说，在 CLion 中配置 ESP32 开发环境可以带来更流畅的代码补全、智能重构和调试体验。

本文将详细介绍如何在 CLion 中配置 ESP32 开发环境，涵盖工具链安装、项目创建、编译调试等完整流程，帮助你快速搭建高效的 C/C++ 开发环境。

注意：该方式是原生方式配置，非插件式。如果想使用插件可以直接到步骤3中的文章最后查看。

2. 环境准备

在开始配置之前，请确保你的系统满足以下要求：

• CLion：2022.3 或更高版本（建议使用最新稳定版）
• ESP-IDF：v5.0 或更高版本（ESP32 官方开发框架）
• Git：用于克隆 ESP-IDF 和项目仓库
• Python 3.8+：ESP-IDF 的依赖管理工具

3. 安装 ESP-IDF 工具链

关于此步骤请参见我的另一篇博客：macOS下的ESP32开发环境配置之离线安装ESP-IDF不走寻常路版

4. 配置 CLion 项目

4.1 创建新项目

1. 打开 CLion，点击 欢迎页中的Open, 找到ESP-IDF目录下的示例代码部分，比如我的路径是/Users/username/Downloads/archive_v6.0/v6.0.1/esp-idf/examples/peripherals/rmt/led_strip_simple_encoder, 这里以led_strip_simple_encoder为例，如果忘记安装目录在哪里可以通过Everything软件搜索led_strip_simple_encoder。
   

2. 打开示例项目后Clion会默认跳出项目配置页，如下图所示：
   
   如果没有，也可以去 settings里 Build,Execution,Deployment下的Cmake配置。
   

3. 接下来我们先配置工具链，点击右侧的 Manage toolchains
   

4. 点击 + 号创建一个新的配置
   
   这里选择第一个 System
   

5. 先修改一下名称，方便区分，然后点击右侧的 Add environment ，选择 From file
   

6. 下方会自动出现 Enviroment file:输入框，点击右侧的文件夹按钮
   

7. 切换到你的ESP-IDF安装目录，找到 export.sh(windows系统选择 export.bat即可)，我这里的目录是 /Users/username/Downloads/archive_v6.0/v6.0.1/esp-idf/
   
   选择完成后直接点击右下方的OK
   

8. Toolchain选择刚刚我们创建的 ESP_IDF即可。
   

4.2 配置 CMake 参数

继续往下看，在Cmake options输入框中输入-DIDF_TARGET=esp32,它的意思是指定你开发板的类型。因为我的是esp32，这里需要根据个人情况填写。

4.3 配置构建目录

直接在 Build directory 填入 build即可，名称你自己定。

整完点击右下角的OK，配置完成。

4.4 校验成果

点完OK后，Clion会自动重新构建，找到Clion左下角的 Cmake图标，查看控制台输出即可，出现如下图所示内容，说明配置成功。

这个时候会在当前项目目录下生成一个build目录，这就是那你之前配置的构建目录。

5. 编译与烧录

点击右上角的 Run/Debug Configurations，选择下拉列表中的 flash。

再点一下 右侧的 小锤子按钮（Build）

查看下方的console,由于我这里没有连接真实设备，忽略下方的报错

写在最后

相较于手动配置，个人还是比较推荐使用插件的方式进行管理，对于新手比较友好。如果想使用插件可以看我的另一篇博客：macOS下的ESP32开发环境配置之离线安装ESP-IDF不走寻常路版 的最后内容。

版权声明：本文为原创文章，遵循 CC BY-NC-SA 4.0 协议，转载请注明出处。