狸花实验室1. ESP-IDF开发环境搭建与路径配置
在开始ESP32开发之前，正确配置ESP-IDF开发环境和路径是至关重要的第一步。许多开发者在这个阶段会遇到各种问题，特别是当系统环境变量设置不正确或工具链路径未正确配置时。
1.1 系统依赖安装
对于Linux系统（以Ubuntu为例），需要先安装以下基础依赖包：
code复制sudo apt-get install git wget flex bison gperf python3 python3-venv python3-setuptools cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0
对于macOS用户，建议使用Homebrew安装必要工具：
code复制brew install cmake ninja dfu-util ccache
注意：如果遇到"xcrun: error"提示，需要先安装Xcode命令行工具：
xcode-select --install
1.2 获取ESP-IDF源码
建议在用户目录下创建专门的esp工作目录：
code复制mkdir -p ~/esp
cd ~/esp
git clone -b v5.1 --recursive https://github.com/espressif/esp-idf.git
克隆完成后，目录结构应为：
code复制~/esp/
└── esp-idf/
├── components/
├── tools/
├── examples/
└── ...
1.3 工具链安装与路径配置
进入esp-idf目录运行安装脚本：
code复制cd ~/esp/esp-idf
./install.sh esp32
安装完成后，需要设置环境变量。建议在shell配置文件中（如.bashrc或.zshrc）添加以下别名：
code复制alias get_idf='. $HOME/esp/esp-idf/export.sh'
之后每次打开新终端，只需运行get_idf即可激活ESP-IDF环境。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。