ESP-IDF for Clion 文档 Help

新建项目

首次使用clion注意事项

如果首次使用clion,第一次新建当前项目的时候，会弹出一个选择Toolchain的窗口，这个时候不要选择， 本插件初始化项目的时候会自动新建属于IDF的Toolchain并创建对应cmake profile选中它。 如果出现该弹窗，待Set Target任务执行完成关掉即可。

windows离线ESP-IDF

  • ESP-IDF 工具安装器 安装

在该地址下载对应版本的ESP-IDF

idf_dl.png

选择一个 Offline Installer(离线安装器) ，无需使用加速器。

下载完成按向导安装，可以勾选附加的驱动。

  • 新建项目 新建项目类型为ESP-IDF的项目，选择Env Type 为ESP-IDF TOOL

win.png

再选择上一步离线包安装的路径如: D:\Espressif。

选择正确会自己加载已安装的ESP-IDF框架。

然后创建项目即可。

源码安装(windows/linux/macos)

通过克隆 ESP-IDF项目，并在对应平台使用install脚本安装ESP-IDF。这样可以通过git更新IDF。

Windows下源码安装

克隆代码后使用install脚本进行安装。

克隆代码

在一个没有空格路径下打开cmd执行以下命令

git clone --recursive https://github.com/espressif/esp-idf.git

无法克隆时使用代理

需要替换代理服务器地址为实际代理程序真实监听地址

:: 设置 HTTP 代理 set http_proxy=http://127.0.0.1:7890 :: 设置 HTTPS 代理 set https_proxy=http://127.0.0.1:7890 git clone --recursive https://github.com/espressif/esp-idf.git

切换到一个具体的稳定版本(可选)

例如v5.5标签

cd esp-idf git checkout v5.5 git submodule update --init --recursive

安装

安装会下载一些东西,根据需要选择后续是否使用镜像站

  • 直接安装

install.bat

  • 或者使用乐鑫下载站

set IDF_GITHUB_ASSETS="dl.espressif.com/github_assets" install.bat

  • 或者使用乐鑫中国下载站

set IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets" install.bat

新建项目

并将Env Type 选为ESP-IDF

win_source.png

再选择对应的源码路径export.bat和export.ps1所在目录。

设置对应target,然后新建项目。

Linux

安装具体依赖的组件

需要手动安装一些组件，再使用install脚本。 参考Linux安装具体的组件

克隆代码

进入一个没有空格的目录，克隆代码。

git clone --recursive https://github.com/espressif/esp-idf.git

无法克隆时使用代理

# 设置 HTTP 代理 export http_proxy=http://192.168.137.1:7890 # 设置 HTTPS 代理 export https_proxy=http://192.168.137.1:7890 git clone --recursive https://github.com/espressif/esp-idf.git

切换到一个具体的稳定版本(可选)

例如v5.5标签

cd esp-idf git checkout v5.5 git submodule update --init --recursive

安装

安装会下载一些东西,根据需要选择后续是否使用镜像站

  • 直接安装

./install.sh

  • 或者使用乐鑫下载站

export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets" ./install.sh

  • 或者使用乐鑫中国下载站

export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets" ./install.sh

新建项目

安装完成之后创建ESP-IDF项目时选择源码路径下export.sh所在的目录。

设置对应target,然后新建项目。

Macos

安装具体依赖的组件

需要手动安装一些组件。 参考macos安装具体的组件

克隆代码

进入一个没有空格的目录，克隆代码。

git clone --recursive https://github.com/espressif/esp-idf.git

无法克隆时使用代理

需要替换代理服务器地址为实际代理程序真实监听地址

export http_proxy=http://127.0.0.1:7890 export https_proxy=http://127.0.0.1:7890 git clone --recursive https://github.com/espressif/esp-idf.git

切换到一个具体的稳定版本(可选)

例如v5.5标签

cd esp-idf git checkout v5.5 git submodule update --init --recursive

安装

安装会下载一些东西,根据需要选择后续是否使用镜像站

  • 直接安装

./install.sh

  • 或者使用乐鑫下载站

export IDF_GITHUB_ASSETS="dl.espressif.com/github_assets" ./install.sh

  • 或者使用乐鑫中国下载站

export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets" ./install.sh

安装完成之后创建ESP-IDF项目时选择源码路径下export.sh所在的目录。

设置对应target,然后新建项目。

重命名Toolchain

生成的Toolchain名称前缀为EspIdfAutoGen ，目前本插件不依赖Toolchain名称，可以重命名。 重命名后，已经配置过的项目需要在cmake profile处重新指定对应名称即可。

31 七月 2025
ESP-IDF for CLion快捷命令树