本地开发环境pip安装依赖失败：--home与--prefix参数冲突

问题根源 #

你没手动添加--home和--prefix参数，但pip会从配置文件或环境变量中自动读取这两个设置，当两者同时存在时就会触发冲突报错。

解决步骤 #

1. 检查并修改pip配置文件

pip的配置文件可能存在以下位置：

• Linux/macOS: ~/.config/pip/pip.conf 或 ~/.pip/pip.conf
• Windows: %APPDATA%\pip\pip.ini 或 C:\ProgramData\pip\pip.ini

打开对应文件，查找是否同时存在home和prefix配置项：

[global]
home = /some/path
prefix = /another/path

删掉其中一项，或者直接移除这两行（如果不需要自定义安装路径的话），保存后重新运行安装命令。

2. 检查环境变量

系统环境变量中如果同时设置了PIP_HOME和PIP_PREFIX也会导致冲突：

• Linux/macOS终端执行：

  echo $PIP_HOME
  echo $PIP_PREFIX
  

• Windows命令提示符执行：

  echo %PIP_HOME%
  echo %PIP_PREFIX%
  

如果两者都有值，临时取消其中一个（比如取消PIP_HOME）：

• Linux/macOS:

  unset PIP_HOME
  

• Windows:

  set PIP_HOME=
  

之后重新运行pip install -r requirements/development.txt。

3. 临时绕过配置（快速测试）

如果不想修改配置或环境变量，可以临时用--no-config参数忽略pip的配置：

pip install -r requirements/development.txt --no-config

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