在使用 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 示例：
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)，根据实际情况进行配置。
