DistutilsOptionError不是pip错误，而是setup.py或pyproject.toml构建配置错误，需修正项目自身声明：删除setup.py中冲突的prefix/home参数、避免混用--prefix/--home、迁移到pip install .或pip install -e .接管构建。
DistutilsOptionError 不是 pip 本身的错误，而是 setup.py 或 pyproject.toml 中构建配置写错了，常见于本地开发或从源码安装时 —— 你得改的是项目自己的构建声明，不是重装 pip 或升级 setuptools。
DistutilsOptionError 出现在 setup.py 里怎么修
这个错误通常长这样：DistutilsOptionError: must supply either home or prefix/exec-prefix -- not both，说明 setup.py 里手动调用了 distutils.core.setup() 并传了冲突参数。
- 检查
setup.py是否有类似setup(..., prefix="/usr", install_lib="/usr/lib/python3.12/site-packages")这种硬编码路径的写法 —— 删除或注释掉这些显式路径参数 - 确认没在
setup()调用里混用--prefix和--home（二者互斥），尤其注意 CI 脚本或 Makefile 里是否通过python setup.py install --prefix=...强制传参 - 如果项目已迁移到
pyproject.toml，就别再跑python setup.py install；改用pip install .或pip install -e .，让构建后端（如 setuptools 或 hatchling）接管参数解析
pip install -e . 报 DistutilsOptionError 的真实原因
执行 pip install -e . 时出这个错，大概率是因为项目依赖了旧版 setuptools（
- 先运行
python -c "import setuptools; print(setuptools.__version__)"看版本；若低于 60.0，升级：pip install -U setuptools - 如果升级后仍报错，检查项目根目录是否存在
setup.cfg，里面是否有[install]段落写了prefix = ...或install_lib = ...—— 这些配置在新 setuptools 中已被弃用，删掉或改用pyproject.toml的[build-system]声明 - 临时绕过：加
--config-settings editable-verbose=true查看具体哪行触发了选项冲突
DistutilsOptionError 和 No module named 'distutils' 是两回事
前者是配置参数打架，后者是模块真没了（Python ≥3.12 移除了 distutils）。但它们可能串着出现：比如你强行在 setup.py 里 import distutils.cmd，又在新 Python 下运行，就会先报 ModuleNotFoundError，再被包装成 DistutilsOptionError。
- 不要试图
pip install distutils—— 它不是独立包，是 Python 标准库一部分，删了就得换 Python 版本或重装系统 Python 包（如 Ubuntu 下sudo apt install python3-distutils） - 如果你用的是 Python 3.12+，且项目必须兼容旧 setup.py，唯一稳妥解法是改用
pyproject.toml+setuptools构建后端，并删掉所有对distutils的显式引用 - CI/CD 中遇到此错，优先检查 runner 的 Python 版本和
setuptools版本是否匹配；Ubuntu 24.04 默认 Python 3.12，但自带的python3-setuptools包可能太老
真正难处理的不是报错本身，而是项目里藏着一个没人维护的 setup.py，它既没迁移到 pyproject.toml，又硬编码了平台路径。这种情况下，光升级工具链没用，得动手改构建逻辑。
