自定义包安装触发subprocess.CalledProcessError：找不到pip模块

核心原因 #

在自定义setuptools安装逻辑中调用subprocess时，若直接使用pip命令或硬编码Python路径，可能会因为wheel构建阶段的隔离环境、路径关联错误等问题，导致无法找到虚拟环境内的pip——哪怕你手动激活了虚拟环境，构建过程的执行上下文也可能和当前终端环境不一致。

解决方案 #

1. 绑定当前Python解释器调用pip #

不要直接执行pip命令，而是通过sys.executable获取虚拟环境内的Python路径，以此调用pip模块，确保使用的是当前虚拟环境的pip：

import subprocess
import sys

# 用虚拟环境的Python运行pip
subprocess.run([sys.executable, "-m", "pip", "install", "pygraphviz", "awesome"], check=True)

2. 禁用构建环境隔离（应急方案） #

如果问题源于setuptools的隔离构建机制，可在pyproject.toml中关闭隔离，让构建过程直接使用当前虚拟环境：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"
isolation = false

⚠️ 注意：此方法会降低构建的可重复性，仅适合临时排查或特定场景使用。

3. 调整自定义逻辑的执行时机 #

自定义install子类的代码可能在wheel构建阶段运行（此时环境未关联虚拟环境），可将依赖安装逻辑移至安装完成后执行，或改用cmdclass确保逻辑在正确阶段触发：

from setuptools import setup, Command

class CustomInstall(Command):
    description = "自定义安装逻辑"
    user_options = []

    def initialize_options(self):
        pass

    def finalize_options(self):
        pass

    def run(self):
        # 先执行默认安装流程
        self.run_command('install')
        # 再安装额外依赖
        import subprocess
        import sys
        subprocess.run([sys.executable, "-m", "pip", "install", "pygraphviz", "awesome"], check=True)

setup(
    # 你的项目配置
    cmdclass={'install': CustomInstall}
)

4. 调试验证环境路径 #

在自定义代码中添加调试输出，确认当前使用的Python和pip是否属于虚拟环境：

import sys
import subprocess

print(f"当前Python路径: {sys.executable}")
result = subprocess.run([sys.executable, "-m", "pip", "--version"], capture_output=True, text=True)
print(f"pip版本信息: {result.stdout}")

通过输出可以快速定位是否存在环境路径不匹配的问题。

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