执行pip3 install依赖安装失败，提示Cannot set --home and --prefix together求助

问题场景 #

执行pip3 install -r requirements.txt安装项目依赖时失败，报错核心内容如下：

Installing build dependencies ... error
error: subprocess-exited-with-error

× pip subprocess to install build dependencies did not run successfully.
│ exit code: 1
╰─> [5 lines of output]
    Collecting setuptools>=40.8.0
      Using cached setuptools-69.1.1-py3-none-any.whl.metadata (6.2 kB)
    Using cached setuptools-69.1.1-py3-none-any.whl (819 kB)
    Installing collected packages: setuptools
    ERROR: Cannot set --home and --prefix together
    [end of output]

执行pip config debug查看配置，发现用户目录下存在有效pip配置文件：

env_var:
env:
global:
  C:\ProgramData\pip\pip.ini, exists: False
site:
  C:\Program Files\Python311\pip.ini, exists: False
user:
  C:\Users\Admin\pip\pip.ini, exists: False
  C:\Users\Admin\AppData\Roaming\pip\pip.ini, exists: True
    global.target: D:Python

补充信息：pip版本24.0，Python版本3.11.8（安装在C盘）

问题根源 #

不是pip.ini缺失，而是**global.target配置导致的参数冲突**。
pip默认会用--prefix参数指向C盘的Python安装路径，而global.target配置会强制pip添加--home参数，这两个参数无法同时使用，从而触发报错。

解决步骤 #

1. 打开用户目录下的pip配置文件：C:\Users\Admin\AppData\Roaming\pip\pip.ini
2. 删除或注释掉global.target = D:Python这一行（注释可在行前加#）
3. 保存文件后，重新执行pip3 install -r requirements.txt即可正常安装依赖

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