克隆GitHub Python包并安装后无法调试，问题出在哪里？

错误原因 #

你使用python setup.py install安装包时，Python会把github-package里的代码复制到你的Python环境的site-packages目录，运行自己的代码时，导入的是这个复制后的副本，而非本地克隆的源码目录，所以无法单步调试本地的包代码。

解决办法 #

有两种常用方式可以实现调试本地包的需求：

• 方式一：使用开发模式安装（推荐）
  进入github-package目录，运行以下命令之一：

  # 用setup.py的开发模式
  python setup.py develop
  # 或者用pip的可编辑模式（更推荐，兼容现代Python环境）
  pip install -e .
  

  这两种命令都会在site-packages中创建一个指向本地github-package目录的链接，之后你导入包时，实际使用的就是本地克隆的源码，调试工具可以直接单步进入包内代码。

• 方式二：手动添加Python路径（临时调试用）
  在你的my-code项目的代码开头，添加以下代码，让Python优先加载本地的github-package目录：

  import sys
  sys.path.insert(0, '../github-package')
  

  这种方式不需要安装包，直接让Python找到本地源码，但缺点是依赖路径配置，不如开发模式规范。

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