### 解决方案 `ModuleNotFoundError: No module named 'distutils'` 的错误通常发生在 Python 安装不完整或者某些标准库模块缺失的情况下。以下是可能的原因以及对应的解决方案： #### 原因分析 1. **Python 版本问题** 部分高版本的 Python 可能存在 `distutils` 被移除的情况，因为官方计划在未来版本中弃用该模块[^2]。 2. **安装过程中的问题** 如果在安装 Python 时未勾选 “Add Python to PATH” 或者安装过程中出现问题，可能导致部分核心组件丢失[^4]。 3. **环境变量配置不当** 系统路径中缺少必要的 Python 执行文件目录，也可能引发此类错误[^1]。 4. **第三方工具冲突** 使用 Conda 或其他虚拟环境管理器时，可能会覆盖或删除默认的标准库模块，例如 `distutils`[^3]。 --- #### 解决方法 ##### 方法一：重新安装 Python 如果当前的 Python 安装存在问题，建议完全卸载并重新安装： - 卸载现有 Python 并清理残留文件（包括注册表项和磁盘上的旧版 Python 文件夹）。 - 下载最新稳定版本的 Python，并确保在安装过程中勾选 “Add Python to PATH”。 ##### 方法二：手动恢复 `distutils` 对于已经安装好的 Python，可以通过以下方式尝试修复： ```bash curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py python get-pip.py --force-reinstall ``` 上述命令会强制重新安装 pip 和其依赖项，其中包括 `setuptools` 和 `wheel`，这些包间接依赖于 `distutils`。 ##### 方法三：降级 Python 版本 如果确认问题是由于高版本 Python 导致，则可以选择安装较低版本的 Python（如 Python 3.9），此版本仍然保留完整的 `distutils` 支持。 ##### 方法四：Conda 用户特定处理 如果是基于 Conda 创建的虚拟环境中遇到此问题，可执行以下操作来修复： ```bash conda install setuptools conda update conda ``` 这一步骤能够更新 Conda 自身及其关联的核心库，从而避免类似问题的发生。 ##### 方法五：检查系统路径设置 验证系统的环境变量是否正确设置了 Python 的 bin 目录。可以在终端输入以下命令测试： ```bash echo %PATH% # Windows 系统下 echo $PATH # Linux/MacOS 系统下 ``` 如果没有找到对应路径，请将其添加到全局环境变量中。 --- ### 总结 通过以上几种途径之一即可有效解决 `ModuleNotFoundError: No module named 'distutils'` 错误。推荐优先采用 **方法一** 或 **方法二** 进行快速排查与修正；而对于特殊场景下的开发者（比如使用 Conda 工具链的人群），则需额外关注 **方法四** 中提到的内容。