Linux下新建项目
选择通过EIM安装的ESP-IDF
通过EIM安装ESP-IDF
新建项目
首次新建项目通过EIM创建工具链
选择新建方式为EIM
选择eim_idf.json 文件 并选择具体esp-idf，至于工具链名称默认会生成，也可以自定义
确认后则可以新建一个工具链
源码安装
安装前置组件
需要手动安装一些组件，再使用install脚本。 参考Linux安装具体的组件
以ubuntu为例
sudo apt update
sudo apt-get install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0
python的版本
目前依赖的python仅仅支持3.10, 3.11, 3.12, 3.13. 3.14 参考idf-im-ui/python版本 不是所有版本支持3.14如果使用ubuntu则推荐ubuntu22 和ubuntu24
安装esp-idf
克隆代码
mkdir -p ~/esp-idf-v6.0
cd ~/esp-idf-v6.0
git clone -b release/v6.0 --recursive https://github.com/espressif/esp-idf.git
# 以idf6.0.1为例，将idf6.0.1的release中附件esp-idf-v6.0.1.zip的url复制出
# 然后替换`github.com` 到 `dl.espressif.cn/github_assets`
cd ~/
wget https://dl.espressif.cn/github_assets/espressif/esp-idf/releases/download/v6.0.1/esp-idf-v6.0.1.zip
unzip esp-idf-v6.0.1.zip
安装
安装会下载一些东西,根据需要选择后续是否使用镜像站
cd ~/esp-idf-v6.0.1
./install.sh
cd ~/esp-idf-v6.0.1
export IDF_GITHUB_ASSETS="dl.espressif.cn/github_assets"
export PIP_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
export PIP_TRUSTED_HOST=mirrors.aliyun.com
./install.sh
install脚本python的编译报错
安装过程中会创建一个虚拟环境，然后pip安装一些依赖，直接安装可能遇到编译失败， 可以新开一个终端，加载虚拟环境的active 文件,再设置python镜像环境变量，仅仅安装二进制文件
新建项目
有以下两种方法新建项目
使用自定义脚本创建工具链
安装完成之后选择以自定义脚本方式选择export.sh创建工具链，可以在创建工具链时自定义工具链名称
或者使用旧版创建方式
会自动生成一个工具链，需要后续自己重命名，以便区分不同版本
01 五月 2026