Python绝对导入异常：运行路径与导入路径调整咨询

1. 如何查看Python查找导入文件的完整路径？ #

有两种实用方法：

• 打印模块搜索路径：在脚本开头或Python交互环境中，导入sys模块后打印sys.path，这个列表里的路径就是Python查找包和模块的顺序。示例代码：

  import sys
  print(sys.path)
  

• 定位特定模块：用importlib.util.find_spec检查目标模块是否可被找到及具体路径，针对你的场景示例：

  import importlib.util
  spec = importlib.util.find_spec("dirA.help_function")
  print(spec)  # 找到则返回模块信息，找不到返回None
  

2. 在subsubdirA中运行代码时，根目录是哪个？ #

当你进入subsubdirA目录执行python file_to_run.py时，Python默认会把subsubdirA目录加入模块搜索路径的最前端，而非repository目录。这就是你导入dirA.help_function失败的主要原因——Python在subsubdirA及其子目录里找不到dirA这个包。

3. 能否修改运行根目录？ #

当然可以，以下是几种可行方案：

• 设置PYTHONPATH环境变量
  运行脚本前，将repository目录的绝对路径添加到PYTHONPATH中。Linux/macOS终端示例：

  export PYTHONPATH="/path/to/repository:$PYTHONPATH"
  

  Windows命令行示例：

  set PYTHONPATH=C:\path\to\repository;%PYTHONPATH%
  

  之后再执行脚本，Python会将repository纳入模块搜索路径，即可找到dirA。

• 在脚本开头修改sys.path
  在file_to_run.py的最顶部添加代码，手动将repository目录加入搜索路径。示例：

  import sys
  import os
  # 假设脚本在subdirA，向上两级即为repository目录
  repo_path = os.path.abspath(os.path.join(os.path.dirname(__file__), "../../"))
  sys.path.insert(0, repo_path)
  

  这样脚本运行时会自动配置搜索路径，无需每次手动设置环境变量。

• 从repository目录下运行脚本
  无需复制file_to_run.py，直接在repository目录执行：

  python dirB/subdirA/file_to_run.py
  

  此时Python会将repository（当前工作目录）加入sys.path，满足绝对导入的要求。

• 用-m参数以模块方式运行
  先在repository目录下新建一个空的__init__.py文件，然后在repository目录执行：

  python -m dirB.subdirA.file_to_run
  

  这种方式会将repository作为顶级包的根目录，完全符合绝对导入的预期。

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