设置PYTHONPATH后无法导入当前目录模块，如何同时支持两类导入？

很多人以为配置PYTHONPATH会主动屏蔽本地目录的导入能力，这是完全的误会。Python从来不会因为设置了环境变量就把当前工作目录从模块搜索路径中移除，你遇到的本地导入失效，本质都是路径搜索优先级错乱、同名包冲突、运行时工作目录偏移三类问题导致的，和PYTHONPATH本身的存在没有必然联系。

Python启动解释器时，会按固定顺序将路径加入sys.path列表，匹配导入语句时从前向后检索，找到第一个匹配的模块就停止加载：

• 执行Python命令时的当前工作目录（交互式启动场景为敲命令时所在的文件夹；脚本运行场景默认为脚本本身所在的文件夹）
• PYTHONPATH环境变量中配置的所有目录
• Python安装自带的标准库目录
• 第三方包安装目录（如site-packages）

按照这个规则，你存放DIR文件夹的项目根目录，永远排在PYTHONPATH配置的中心仓库路径前面，理论上不存在PYTHONPATH挤掉本地导入优先级的可能。

• PYTHONPATH配置写法错误：直接用=覆盖原有环境变量值，虽然不会把本地路径挤出搜索列表，但如果中心仓库下存在和本地项目同名的顶层目录（比如中心仓库也有个叫DIR的文件夹），一旦运行时工作目录不对，Python就会错把中心仓库的同名内容当成本地模块加载。
• 运行脚本的工作目录偏移：原本你是在存放DIR文件夹的项目根目录下执行python run.py，如果不小心cd到项目子目录下再启动解释器，Python自动插入的第一个搜索路径就不再是项目根目录，自然找不到import DIR.module对应的文件，这类问题就算不配置PYTHONPATH也会出现，和环境变量没有关系。
• 优先级手动篡改：写PYTHONPATH时把中心仓库路径拼到了配置值的最前面，或者在代码里手动修改sys.path把中心仓库插到列表开头，就会让中心仓库的同名模块抢占本地模块的匹配。

按下面的方法配置，可以同时满足本地导入、中心仓库导入的需求，完全不会打乱原本的导入逻辑：

• 配置PYTHONPATH时采用追加方式写入新路径，不要直接覆盖原有环境变量值。Linux/macOS下路径分隔符为冒号，Windows下为分号：

  # 将中心仓库路径追加到PYTHONPATH末尾，不要放到配置最前端
  export PYTHONPATH="$PYTHONPATH:/path/to/repository"
  

  这种写法下，中心仓库路径永远排在本地工作目录、脚本所在目录的后面，Python会优先匹配本地模块，找不到对应内容时才会去中心仓库查找，完全兼容你原本的import DIR.module写法。
• 永远在存放DIR文件夹的项目根目录下执行Python运行命令，不要随意cd到项目子目录下启动解释器。
• 如果不确定路径顺序是否正常，可以在代码中加入两行打印语句排查：

  import sys
  print(sys.path)
  

  正常输出顺序里，你的项目根目录一定会排在靠前位置，中心仓库路径会出现在PYTHONPATH对应的区间，不会跑到本地路径前面。

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