Fax CaelestisESP32开发环境搭建：手把手教你解决Python依赖报错（ESP-IDF V4.2实测）
第一次接触ESP32开发时，最令人头疼的莫过于环境搭建过程中层出不穷的Python依赖报错。作为一个刚从Arduino转向ESP-IDF的开发者，我也曾被The following Python requirements are not satisfied这类错误折磨得焦头烂额。本文将基于ESP-IDF V4.2版本，带你从零开始搭建一个干净的开发环境，并深入分析那些令人困惑的报错背后的原因。
1. 环境准备：从混乱到有序
很多开发者的电脑就像我的工作台一样杂乱——同时安装了多个版本的Python、各种SDK工具链，环境变量像一团乱麻。这种环境下运行ESP-IDF，不出问题才怪。
1.1 清理历史遗留问题
首先我们需要检查系统中已安装的Python环境：
bash复制ls -l /usr/bin/python*
典型的输出可能如下：
code复制/usr/bin/python -> python2.7
/usr/bin/python2 -> python2.7
/usr/bin/python2.7
/usr/bin/python3 -> python3.6
/usr/bin/python3.6
/usr/bin/python3.8
ESP-IDF V4.2官方推荐使用Python 3.8，我们需要确保系统默认Python版本正确：
bash复制sudo update-alternatives --config python
注意：不要直接删除/usr/bin/python链接，这可能导致系统组件异常
1.2 工具链隔离安装
为了避免与现有开发环境冲突，建议为ESP32创建独立的开发空间：
bash复制mkdir -p ~/esp32_dev
cd ~/esp32_dev
git clone --recursive https://github.com/espressif/esp-idf.git
cd esp-idf
git checkout v4.2
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Python依赖问题深度解析
当看到`The following Python requirements are