如何使用pip install --target安装时跳过系统已兼容依赖包？

核心思路 #

pip的--target模式默认会将所有依赖强制安装到目标目录，不会考虑当前环境已有的包。要实现跳过系统兼容依赖，需要让pip在依赖解析阶段识别系统已安装的兼容版本，仅安装目标目录缺失的依赖。

方法一：--no-deps配合依赖补装 #

1. 仅安装目标包，跳过所有依赖
   先把目标包单独安装到指定目录，不附带任何依赖：

   pip install --target /your/target/dir --no-deps requests
   

2. 检查目标目录的依赖缺失情况
   用pip check命令查看目标目录下的包缺少哪些依赖：

   pip check --target /your/target/dir
   

3. 选择性安装缺失的依赖
   对于检查出的缺失依赖，先确认系统是否已安装兼容版本：

   pip show urllib3  # 查看系统中urllib3的版本
   

   如果系统版本满足目标包的依赖要求，就无需安装；若不满足，则安装到目标目录：

   pip install --target /your/target/dir urllib3
   

方法二：借助虚拟环境的--system-site-packages间接实现 #

如果依赖关系复杂，可通过临时虚拟环境过渡：

1. 创建继承系统站点包的虚拟环境

   python -m venv --system-site-packages /tmp/venv-temp
   

2. 激活虚拟环境并安装目标包

   source /tmp/venv-temp/bin/activate  # Linux/macOS
   # Windows系统执行：\tmp\venv-temp\Scripts\activate.bat
   pip install requests
   

3. 复制新增包到目标目录
   虚拟环境的site-packages中只会存在新安装的包（如requests），继承的系统包不会被复制，直接将这些新增包拷贝到目标目录：

   cp -r /tmp/venv-temp/lib/pythonX.X/site-packages/requests* /your/target/dir/
   # 替换pythonX.X为你的Python版本，例如python3.10
   

4. 清理临时环境

   deactivate
   rm -rf /tmp/venv-temp
   

说明 #

目前pip没有为--target模式提供类似--system-site-packages的直接选项，上述两种方法是当前可行的替代方案。方法一更轻量，适合简单场景；方法二更自动化，适合依赖复杂的包。

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