如何用pipenv在本地调试两个GitHub托管的带setup.py的Python库？

你完全不需要绕弯做“只装依赖不装库本体”的操作，Python为本地代码调试场景准备的*可编辑安装（editable install）*模式，天生就能满足你所有需求：

• 这个模式不会把你的库代码拷贝到虚拟环境的lib目录，只会在虚拟环境里写入一个指向你本地库路径的软引用，你在本地修改的代码会被Python实时识别，不需要每次改完重新安装
• 安装过程会自动读取库内置的setup.py/pyproject.toml里声明的依赖清单，自动把所有依赖装进当前虚拟环境，完全不用手动梳理依赖一个个安装
• 对应pipenv的操作也很简单：先把两个GitHub仓库克隆到本地工作区，比如放在./repo1、./repo2目录下，在工作区根目录执行两条命令即可：

  pipenv install --editable ./repo1
  pipenv install --editable ./repo2
  

• 注意：editable安装时不需要把lib1、lib2文件夹从对应的repo目录里挪出来，安装完成后你在repo目录里改任何代码都会实时生效，比手动挪文件夹的方式安全得多
• 要纠正你之前的操作误区：直接跑pipenv install .不会只安装依赖，它会做普通的全量安装——也就是把当前目录的库代码完整拷贝到虚拟环境的lib目录，之后你修改本地的代码，虚拟环境里的Python根本读不到，完全达不到边改边调的效果

你遇到的所有导入报错，本质上都是Python的模块搜索路径机制导致的：
Python运行脚本时，会自动把当前正在运行的脚本所在的目录加到模块搜索路径的最前面，之后再依次搜索虚拟环境内置目录、系统Python的库目录，路径里没有的目录，Python就找不到对应的模块。

• 回到你最开始的目录结构（两个库分别在repo1/lib1、repo2/lib2下，mypyfile1.py在工作区根目录）：你在mypyfile1.py里直接导入lib1、lib2确实会报错，因为此时搜索路径里根本没有repo1、repo2这两个目录，Python不知道去哪里找对应的代码
• 你把lib1、lib2挪到工作区根目录后，mypyfile1.py能正常导入是因为这个脚本本身就在根目录，根目录属于自动加入搜索路径的范围；但mypyfile2.py在mymodule子目录里，运行时Python自动加载的搜索路径是mymodule目录，根目录不在路径列表里，自然就没法导入lib1、lib2
• 用前面提到的可编辑安装之后，这些导入问题会直接消失：editable安装会把两个库对应的仓库路径永久写入虚拟环境的搜索路径配置，不管你运行的脚本在工作区的哪个子目录，Python都能正常找到lib1、lib2，根本不需要你手动挪动代码文件夹

如果不想用editable安装，也有两个临时替代方案，但维护成本远高于editable模式：

• 方案一：在每个需要导入lib1、lib2的脚本最开头，手动把工作区根目录加到搜索路径里，比如在mypyfile2.py开头写：

  import sys
  from pathlib import Path
  # 把当前脚本所在目录的上一级（也就是工作区根目录）加入搜索路径
  sys.path.append(str(Path(__file__).parent.parent.resolve()))
  

  这种方法的问题是每个用到这两个库的脚本都要重复写这段代码，非常冗余
• 方案二：在虚拟环境的site-packages目录里手动新建一个.pth后缀的文本文件，文件里逐行写lib1、lib2所在的绝对路径，Python启动时会自动读取这类文件把路径加入搜索列表。但如果你之后挪动了工作区的存储位置，还要手动修改这个文件里的路径，长期维护很麻烦

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