执行pip install -r requirements.txt时遇distutils缺失错误求助

针对你遇到的pip install -r requirements.txt报错缺少distutils模块的问题，结合不同系统给出具体修复步骤：

• Debian/Ubuntu类Linux系统
  distutils并非Python默认自带的系统级组件，需要单独安装。执行以下命令：
  sudo apt update
sudo apt install python3-distutils
  如果你用的是指定版本的Python（比如3.11/3.12），可以安装对应版本的包：
  sudo apt install python3.11-distutils 或 sudo apt install python3.12-distutils

• RHEL/CentOS/Fedora类Linux系统
  通过包管理器安装对应组件：
  sudo dnf install python3-distutils
  同样可指定版本安装，比如python3.11-distutils

• Windows系统
  重新启动Python官方安装程序，选择「Modify」（修改）选项，在可选功能列表中找到「Python distutils」并勾选，完成补装。如果是全新安装，确保勾选该组件同时不要遗漏「Add Python to PATH」选项。

• macOS系统

  • 若使用官方Python安装包：重新运行安装程序，确保勾选「Install Certificates」和「Add Python to PATH」，distutils会随安装包自动配置。
  • 若使用Homebrew安装Python：执行对应版本的重装命令，Homebrew编译的Python默认包含distutils：
    brew reinstall python@3.11（替换为你使用的Python版本）

• 虚拟环境排查
  如果使用了虚拟环境，可能是创建时依赖的Python环境缺失distutils。尝试删除现有虚拟环境后重建：

  # Linux/macOS
  rm -rf venv
  python3.11 -m venv venv
  source venv/bin/activate
  

  # Windows
  rmdir /s venv
  python3.11 -m venv venv
  venv\Scripts\activate.bat
  

  激活后再次执行pip install -r requirements.txt

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