解决 pip 安装本地包时构建失败，提示找不到已安装的依赖包-Python教程-PHP中文网

解决 pip 安装本地包时构建失败，提示找不到已安装的依赖包

霞舞

发布： 2025-09-20 11:40:22

原创

1011人浏览过

解决 pip 安装本地包时构建失败，提示找不到已安装的依赖包

在使用 pip 安装本地包时，如果构建过程中出现 ModuleNotFoundError，提示找不到已安装的依赖包（例如 numpy），这通常是因为 pip 使用了隔离的构建环境，导致无法识别系统已安装的包。本文将介绍如何通过修改 setup.py 文件来解决这个问题，确保构建过程能够正确找到所需的依赖。

问题分析

当使用 pip install . 安装本地包时，pip 会创建一个临时的、隔离的构建环境。在这个环境中，只有最基本的 Python 环境，以及 pyproject.toml 文件中指定的构建依赖。如果你的 setup.py 文件中使用了某些依赖包（例如 numpy），但在构建环境里没有安装，就会出现 ModuleNotFoundError 错误。

解决方案

解决这个问题的关键在于告诉 pip 在构建环境中安装 setup.py 文件所需的依赖。可以通过在 setup() 函数中添加 setup_requires 参数来实现。

修改 setup.py

打开你的 setup.py 文件，找到 setup() 函数，添加 setup_requires 参数，将缺失的依赖包添加到列表中。

from setuptools import setup, find_packages

setup(
    name='mypackagename',
    version='0.1.0',
    packages=find_packages(),
    install_requires=[
        # 你的运行时依赖
    ],
    setup_requires=[
        'numpy'  # 添加 numpy 作为构建依赖
    ],
    # 其他参数...
)

登录后复制

在这个例子中，我们将 numpy 添加到了 setup_requires 列表中。这意味着在构建 mypackagename 的 wheel 文件之前，pip 会先安装 numpy。

完整示例

下面是一个更完整的 setup.py 示例：

豆包爱学

豆包旗下AI学习应用

674

查看详情

from setuptools import setup, find_packages

with open("README.md", "r", encoding="utf-8") as fh:
    long_description = fh.read()

setup(
    name="mypackagename",
    version="0.1.0",
    author="Your Name",
    author_email="your.email@example.com",
    description="A small example package",
    long_description=long_description,
    long_description_content_type="text/markdown",
    url="https://github.com/yourusername/mypackagename",
    packages=find_packages(),
    classifiers=[
        "Programming Language :: Python :: 3",
        "License :: OSI Approved :: MIT License",
        "Operating System :: OS Independent",
    ],
    python_requires='>=3.6',
    install_requires=[
        # 运行时依赖，例如 'requests', 'beautifulsoup4'
    ],
    setup_requires=[
        'numpy', # 构建依赖
        'setuptools', # 确保 setuptools 是最新的
        'wheel' # 确保 wheel 是最新的
    ],
)

登录后复制

注意：

install_requires 用于指定运行时依赖，即你的包在运行过程中需要的依赖。
setup_requires 用于指定构建依赖，即在构建 wheel 文件时需要的依赖。
确保 setuptools 和 wheel 也包含在 setup_requires 中，以确保构建环境使用最新版本的构建工具。

重新安装

修改 setup.py 文件后，重新运行 pip install . 命令。pip 现在应该能够正确安装构建所需的依赖，并成功构建你的包。

python3 -m pip install -vvv .

登录后复制

-vvv 参数可以提供更详细的输出，方便调试。

总结

通过在 setup.py 文件的 setup() 函数中添加 setup_requires 参数，可以解决 pip 在构建隔离环境时找不到已安装依赖的问题。确保将所有构建所需的依赖包添加到 setup_requires 列表中，以便 pip 能够正确构建你的包。记住区分运行时依赖(install_requires)和构建依赖(setup_requires)，根据实际情况进行配置。

以上就是解决 pip 安装本地包时构建失败，提示找不到已安装的依赖包的详细内容，更多请关注php中文网其它相关文章！