基于本地两个GitHub Python包的调用脚本出现模块缺失报错的原因咨询

你遇到的报错本质上不是自己写的两行导入语句写错了，是当前目录结构、Python搜索路径、GitHub拉取的包本身的内置导入逻辑三者完全不匹配，具体是三个高频踩坑点导致的：

• GP1、GP2目录没有被Python识别为合法可导入包
  按照Python导入规则，要把一个文件夹识别为可导入的包，要么目录下有标记包身份的__init__.py文件，要么结构符合隐式命名空间包的要求。你直接把从GitHub拉的项目文件夹丢在脚本同级目录下，没有任何包标记时，Python只会把这些文件夹当成普通的资源目录，不会按照包的层级规则解析文件内部的导入逻辑。
• 打乱了GitHub包原本内置的固定导入路径
  绝大多数从GitHub拉取的Python项目，代码内部的导入语句是按照「包源码自身的原生目录层级」写死的——比如GP1里的fileToIncludeFromGP1.py，原本代码里大概率写了同层级依赖导入、上级目录模块导入的语句（比如from .utils import config、from gp1.core import process）。你直接把整个项目文件夹拖到myScriptFolder下运行时，Python的导入根路径完全偏移了，这些原本写好的内部导入语句全部会因为路径匹配不上，抛出“依赖文件缺失”的报错。
• Python模块搜索路径不覆盖包的内部依赖位置
  当你直接在myScriptFolder目录下运行python myScript.py时，Python只会把「myScriptFolder的绝对路径」加入全局模块搜索路径sys.path。如果GP1、GP2包内部的依赖资源（比如配置文件、子模块目录）不在myScriptFolder的可递归识别范围内，或者包本身需要把自身所在的目录加入搜索路径才能加载资源，就会触发模块、资源找不到的报错。

容易混淆的判断逻辑：为什么自己写的两行导入语句没报错，反而包内部的依赖全部找不到？因为你写的导入逻辑是顺着当前目录层级写的，刚好能匹配到最外层的两个py文件；但py文件内部的导入逻辑是按照项目原本的目录设计写的，和你当前打乱的层级不匹配，所以报错只会出现在包内部依赖的解析阶段。

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