Ubuntu 23.10安装ESP-IDF v4.4.2报错求助：无法完成安装

1. 修复python命令找不到的问题 #

Ubuntu 23.10默认仅提供python3命令，无python软链接，直接创建即可：

sudo ln -s /usr/bin/python3 /usr/bin/python

2. 解决externally-managed-environment错误 #

不要用sudo运行install.sh，普通用户权限即可——root用户下pip会直接修改系统Python环境，触发外部管理限制；普通用户运行时，脚本会在用户目录独立创建虚拟环境，不会冲突。

若仍提示找不到virtualenv，先手动安装用户级别的virtualenv（无需sudo）：

pip install --user virtualenv

确保用户本地bin目录在PATH中（临时生效，可加入~/.bashrc或~/.zshrc永久生效）：

export PATH="$HOME/.local/bin:$PATH"

3. 解决gevent等编译错误 #

ESP-IDF v4.4.2对Python 3.11兼容性不佳，而Ubuntu 23.10默认搭载Python 3.11，这是编译失败的核心原因，两种解决方式可选：

方式一：全局降级Python到3.10 #

1. 安装Python 3.10相关组件：

sudo apt install python3.10 python3.10-venv python3.10-dev

2. 重新设置python软链接指向3.10：

sudo rm /usr/bin/python
sudo ln -s /usr/bin/python3.10 /usr/bin/python

3. 重新运行安装脚本：

./install.sh esp32c3

方式二：指定Python版本运行安装脚本 #

无需全局修改，直接让安装脚本使用Python 3.10：

PYTHON=/usr/bin/python3.10 ./install.sh esp32c3

验证安装 #

安装完成后，激活ESP-IDF环境：

. ./export.sh

执行以下命令确认安装成功：

idf.py --version

内容的提问来源于stack exchange，提问作者Griffin