[esp-idf]macos 环境安装 v6.0

安装文档

官方

通过命令行安装

/Applications/eim.app/Contents/MacOS/eim install

help 说明

/Applications/eim.app/Contents/MacOS/eim --help
All you need to manage your ESP-IDF installations

Usage: eim [OPTIONS] [COMMAND]

Commands:
  install          Install ESP-IDF versions
  list             List installed ESP-IDF versions
  select           Select an ESP-IDF version as active
  discover         Discover available ESP-IDF versions (not implemented yet)
  remove           Remove specific ESP-IDF version
  rename           Rename specific ESP-IDF version
  run              Run command in the context of a specific ESP-IDF version
  import           Import existing ESP-IDF installation using tools_set_config.json
  purge            Purge all ESP-IDF installations
  wizard           Run the ESP-IDF Installer Wizard
  gui              Run the ESP-IDF Installer GUI with arguments passed through command line
  fix              Fix the ESP-IDF installation by reinstalling the tools and dependencies
  install-drivers  Install drivers for ESP-IDF. This is only available on Windows platforms
  completions      Generate shell completion script to stdout
  help             Print this message or the help of the given subcommand(s)

Options:
  -l, --locale <LOCALE>
          Set the language for the wizard (en, cn)

  -v, --verbose...
          Increase verbosity level (can be used multiple times)

      --log-file <LOG_FILE>
          file in which logs will be stored (default: eim.log)

      --do-not-track <DO_NOT_TRACK>
          If set to true, the installer will not send any usage data. Default is false.
          
          [default: false]
          [possible values: true, false]

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

help中文说明

命令
install
安装 ESP-IDF 版本

list
列出已安装的 ESP-IDF 版本

select
选择某个 ESP-IDF 版本作为当前活动版本

discover
发现可用的 ESP-IDF 版本（尚未实现）

remove
删除指定的 ESP-IDF 版本

rename
重命名指定的 ESP-IDF 版本

run
在指定 ESP-IDF 版本的环境中运行命令

import
使用 tools_set_config.json 导入现有的 ESP-IDF 安装

purge
清除所有 ESP-IDF 安装

wizard
运行 ESP-IDF 安装向导

gui
运行 ESP-IDF 安装图形界面，并将命令行参数传递给图形界面

fix
通过重新安装工具和依赖来修复 ESP-IDF 安装

install-drivers
安装 ESP-IDF 所需驱动，仅在 Windows 平台可用

completions
生成 shell 自动补全脚本并输出到标准输出

help
打印帮助信息，或者打印指定子命令的帮助信息

选项
-l, --locale <LOCALE>
设置向导语言（en、cn）

-v, --verbose...
增加详细日志级别（可多次使用）

--log-file <LOG_FILE>
指定日志保存的文件（默认：eim.log）

--do-not-track <DO_NOT_TRACK>
如果设置为 true，安装器将不会发送任何使用数据。默认值为 false。
可选值：

true
false
-h, --help
打印帮助信息（使用 -h 可查看简要摘要）

-V, --version
打印版本号

命令行参考

# 安装指定版本的 ESP-IDF
eim install -i v5.3.2

# 运行交互式向导
eim wizard

# 列出已安装的版本
eim list

使用向导也很好用

/Applications/eim.app/Contents/MacOS/eim wizard
2026-04-27 10:21:47 - 10 - 04 - INFO - Running IDF Installer Wizard...
2026-04-27 10:21:47 - 10 - 04 - INFO - All prerequisites are satisfied!
2026-04-27 10:21:47 - 10 - 04 - INFO - Running python sanity check
⢀ Doing something...                                                                                                                         2026-04-27 10:21:48 - 10 - 04 - INFO - Found python3
⢀ Doing something...                                                                                                                           [PASS] Python Version
  [PASS] pip
  [PASS] venv
  [PASS] Standard Library (json, os, platform)
  [PASS] ctypes
  [PASS] SSL/HTTPS
2026-04-27 10:21:51 - 10 - 04 - INFO - Your Python meets the requirements
✔ Please select all of the target platforms (ESP chips) · esp32s3
✔ Please select the desired ESP-IDF version · v6.0
2026-04-27 10:21:58 - 10 - 04 - INFO - Starting mirror latency checks (2 candidates)...
2026-04-27 10:21:59 - 10 - 04 - INFO - Mirror score: https://github.com -> 452
2026-04-27 10:21:59 - 10 - 04 - INFO - Mirror score: https://jihulab.com/esp-mirror -> 641
✔ Select the source from which to download ESP-IDF · https://github.com (452 ms)
2026-04-27 10:22:06 - 10 - 04 - INFO - Starting mirror latency checks (3 candidates)...
2026-04-27 10:22:06 - 10 - 04 - INFO - Mirror score: https://github.com -> 476
2026-04-27 10:22:07 - 10 - 04 - INFO - Mirror score: https://dl.espressif.com/github_assets -> 660
2026-04-27 10:22:07 - 10 - 04 - INFO - Mirror score: https://dl.espressif.cn/github_assets -> 248
✔ Select a source from which to download tools · https://dl.espressif.cn/github_assets (248 ms)
2026-04-27 10:22:21 - 10 - 04 - INFO - Starting mirror latency checks (4 candidates)...
2026-04-27 10:22:22 - 10 - 04 - INFO - Mirror score: https://pypi.org/simple -> 960
2026-04-27 10:22:22 - 10 - 04 - WARN - Mirror ping failed with HEAD for https://mirrors.aliyun.com/pypi/simple
2026-04-27 10:22:23 - 10 - 04 - INFO - Mirror get score: https://pypi.org/simple -> 895
2026-04-27 10:22:23 - 10 - 04 - WARN - Mirror ping failed for https://mirrors.aliyun.com: 403
2026-04-27 10:22:23 - 10 - 04 - INFO - Unable to measure get latency for https://mirrors.aliyun.com/pypi/simple: 3s
2026-04-27 10:22:25 - 10 - 04 - INFO - Mirror get score: https://pypi.tuna.tsinghua.edu.cn/simple -> 1904
2026-04-27 10:22:26 - 10 - 04 - INFO - Mirror get score: https://pypi.mirrors.ustc.edu.cn/simple -> 775
✔ Select a PyPI mirror to download Python packages · https://pypi.mirrors.ustc.edu.cn/simple (775 ms)
✔ Please select the ESP-IDF installation location · /Users/xiesi/.espressif
✔ Select ESP-IDF features to install (Space to toggle, Enter to confirm) · core - Core packages necessary for ESP-IDF, ide - Packages for IDE support in ESP-IDF
2026-04-27 10:25:11 - 10 - 04 - WARN - Failed to read tools configuration: HTTP error: error sending request for url (https://github.com/espressif/esp-idf/raw/v6.0/tools/tools.json). Tool selection will not be available for this version.
2026-04-27 10:25:11 - 10 - 04 - INFO - Cloning ESP-IDF
2026-04-27 10:25:11 - 10 - 04 - ERROR - Download ESP-IDF failed "Refusing to initialize the non-empty directory as '/Users/xiesi/.espressif/v6.0/esp-idf'"

http超时

# 测试
python3 -c "import urllib.request; print(urllib.request.urlopen('https://www.baidu.com').status)"

# 安装 certifi
pip install certifi

# 获取证书路径并测试
python3 -c "import certifi; print(certifi.where())"

# 添加到 shell 配置文件（根据你使用的 shell 选择）
# 如果使用 zsh (macOS 默认)
echo 'export SSL_CERT_FILE=$(python3 -c "import certifi; print(certifi.where())" 2>/dev/null)' >> ~/.zshrc
echo 'export REQUESTS_CA_BUNDLE=$SSL_CERT_FILE' >> ~/.zshrc
source ~/.zshrc

# 如果使用 bash
echo 'export SSL_CERT_FILE=$(python3 -c "import certifi; print(certifi.where())" 2>/dev/null)' >> ~/.bash_profile
echo 'export REQUESTS_CA_BUNDLE=$SSL_CERT_FILE' >> ~/.bash_profile
source ~/.bash_profile

还要不要 install.sh

# 查看基础环境
cd ~/Espressif/frameworks/esp-idf-v6.0.0
source export.sh
idf.py --version

# 检查工具链
which xtensa-esp32s3-elf-gcc
xtensa-esp32s3-elf-gcc --version

# 检查target
idf.py set-target esp32s3

# 直接操作版本
cd ~/你的esp-idf路径
source export.sh
idf.py --version
which idf.py

# 如果这里不行，再执行：
./install.sh esp32s3
source export.sh
idf.py --version