认识 EIM
从 ESP-IDF v6.0 起,官方推荐用 ESP-IDF 安装管理器(EIM)完成安装:它把框架、工具链、CMake 和 Ninja 等构建工具一次性装好,还提供版本管理。EIM 分图形界面(GUI)和命令行(CLI)两种用法,当前稳定版 ESP-IDF 是 v6.1。
Windows 安装
前置要求是 Git 和 Python(3.10 起支持),EIM 安装时会自动检测并提示补装。装 EIM 推荐 WinGet:
winget install Espressif.EIM
只需要命令行版本的话:
winget install Espressif.EIM-CLI
然后用 EIM 装 ESP-IDF。新手直接装最新稳定版:
eim install
想交互式选择版本和路径,用安装向导:
eim wizard
也可以直接指定版本,例如装 v5.4.2:
eim install -i v5.4.2
安装成功的标志是终端输出 Successfully installed IDF。图形界面用户打开 eim 应用,New Installation 里走 Easy Installation 即可。
Linux 安装
Debian 和 Ubuntu 系先添加乐鑫 APT 源:
echo "deb [trusted=yes] https://dl.espressif.com/dl/eim/apt/ stable main" | sudo tee /etc/apt/sources.list.d/espressif.list
sudo apt update
sudo apt install eim
Fedora 等 RPM 系用 DNF:
sudo tee /etc/yum.repos.d/espressif-eim.repo << 'EOF'
[eim]
name=ESP-IDF Installation Manager
baseurl=https://dl.espressif.com/dl/eim/rpm/$basearch
enabled=1
gpgcheck=0
EOF
sudo dnf install eim
之后同样用 eim install 装最新版或 eim wizard 走向导。
使用前:激活环境
ESP-IDF 的工具不能直接在新终端里用,每次开发前要先激活环境。用 EIM 图形界面的话,在 Manage Installations 里打开 Open IDF Terminal,它会启动一个已激活的终端。命令行用户按 EIM 提示的激活方式操作即可。
验证方法:激活后的终端里能直接运行 idf.py --help。
卸载
EIM CLI 可以按版本卸载或全部清除:
eim remove v5.4.2
eim purge
常见问题
- Python 版本过低:ESP-IDF 最低要求 Python 3.10,装新一点的 Python 再重试。
- 路径里有空格:ESP-IDF 的构建系统不支持 ESP-IDF 和项目路径中带空格,安装和建项目时都注意。
- 想用 IDE:EIM 装好的 IDF 可以直接配到 VS Code 的 ESP-IDF 扩展或乐鑫的 Espressif-IDE 里用。
下一步
环境装好后,到第一个程序页用 idf.py 完成构建、烧录和监视。