Python虚拟环境中pip不识别已安装本地包的问题求助

问题 #

我创建了名为pyikarus的Python包，希望在Python虚拟环境（venv）中通过pip安装。该包存在多个依赖项，部分依赖不在PyPI上但已本地安装。

执行以下命令激活虚拟环境并查看已安装包：

python -m venv /.../venv/
source /.../venv/bin/activate
pip list

结果显示多个dune-*系列包已以可编辑模式安装，版本符合要求。但执行pip install pyikarus --verbose或python -m pip install pyikarus --verbose时，pip未识别这些已安装的dune-*包，反而尝试从PyPI下载相关包，最终因dune-functions不在PyPI上报错：

ERROR: Could not find a version that satisfies the requirement dune-functions<=2.9.0 (from versions: none)
ERROR: No matching distribution found for dune-functions<=2.9.0

我的setup.py文件中依赖项配置如下：

requires = ['setuptools', 'wheel', 'scikit-build', 'cmake', 'ninja', 'requests', 'dune-common<=2.9.0', 'dune-grid<=2.9.0', 'dune-geometry<=2.9.0', 'dune-localfunctions<=2.9.0', 'dune-functions<=2.9.0', 'dune-istl<=2.9.0']

请问安装流程哪里出错？为何pip不识别这些已安装依赖包？或能否提供调试思路？

原因分析与解决思路 #

核心原因 #

pip解析依赖时，会优先验证PyPI上是否存在对应包（哪怕本地已安装），尤其是依赖项带版本约束（比如<=2.9.0）时，pip需要确认PyPI上有符合约束的版本存在——但dune-functions不在PyPI上，导致验证失败，直接跳过本地已安装包的检查。

另外，本地以**可编辑模式（editable install）**安装的dune-*包，如果其setup.py中的包名、版本号与pyikarus依赖中声明的不完全匹配，也会导致pip无法识别。

调试与解决步骤 #

• 检查本地dune-*包的元数据
  执行pip show dune-functions，查看输出中的Name和Version字段，确认是否和pyikarus依赖中写的dune-functions<=2.9.0完全一致（注意大小写、版本格式，比如是否是2.9.0而非2.9）。
• 修改依赖声明与安装方式
  1. 临时安装方案：安装pyikarus时跳过PyPI索引，仅使用本地已安装包：

     pip install pyikarus --verbose --no-index
     

     若本地包存放在特定路径，可补充指定：

     pip install pyikarus --verbose --no-index --find-links=file:///path/to/your/local/dune-packages
     

     仅临时测试的话，可直接跳过依赖检查（不推荐用于正式环境）：

     pip install pyikarus --verbose --no-deps
     

  2. 永久配置方案：改用pyproject.toml的[project]字段，直接指定本地包路径替代PyPI依赖：

     [project]
     dependencies = [
         "setuptools",
         "wheel",
         "scikit-build",
         "cmake",
         "ninja",
         "requests",
         "dune-common@ file:///path/to/dune-common",
         "dune-grid@ file:///path/to/dune-grid",
         "dune-geometry@ file:///path/to/dune-geometry",
         "dune-localfunctions@ file:///path/to/dune-localfunctions",
         "dune-functions@ file:///path/to/dune-functions",
         "dune-istl@ file:///path/to/dune-istl"
     ]
     

• 验证pip依赖解析逻辑
  使用pip check命令检查虚拟环境中已安装包的依赖冲突，或用pip install pyikarus --verbose --dry-run查看pip的依赖解析过程，确认它是否扫描到了本地已安装的dune-*包。
• 确认可编辑安装的包注册状态
  可编辑模式安装的包会在虚拟环境的site-packages目录下生成.egg-link文件，检查该文件是否指向正确的本地包路径，且包的setup.py中version字段符合版本约束。

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