【Python - 基础 - 工具】ModuleNotFoundError: No module named ‘distutils‘的解决办法

ModuleNotFoundError: No module named ‘distutils‘的解决办法

当您遇到 ModuleNotFoundError: No module named 'distutils' 错误时，通常是因为 Python 版本较新（如 3.12 或更高版本）已移除了 distutils 模块，而某些工具（如 pip 或 setuptools）仍然依赖它。

示例错误

Traceback (most recent call last): File "main.py", line 1, in <module> from distutils import spawn ModuleNotFoundError: No module named 'distutils' 

解决方法

方法 1: 安装 setuptools

setuptools 是一个依赖于 distutils 的工具包，安装它可以间接解决问题。

pip install setuptools 

方法 2: 使用 ensurepip 和最新的 pip

对于 Python 3.12+，可以通过以下步骤安装兼容的 pip 和 setuptools，无需依赖 distutils。

python3 -m ensurepip --upgrade curl -sS https://bootstrap.pypa.io/get-pip.py -o get-pip.py python3 get-pip.py 

方法 3: 降级 Python 版本

如果上述方法无效，可以考虑降级到 Python 3.11 或更低版本，因为这些版本仍然包含 distutils 模块。

#示例：使用 pyenv 安装旧版本 Python pyenv install 3.11.5 pyenv global 3.11.5 

通过以上方法，您可以有效解决缺少 distutils 模块的问题，并继续正常使用相关工具。