Python跨目录模块调用问题：同包内文件互导实现方案咨询

问题背景 #

目录结构如下：

├── PackageName    
│   ├── __init__.py (空)   
│   ├── file_1.py  
│   ├── Folder1  
│   │    ├── file_2.py   
│   │    ├── file_3.py  
│   ├── Folder2  
│   │    ├── file_4.py   
│   │    ├── file_5.py 

需求：任意文件可互相导入（如file_1导入file_3的类，file_3依赖file_4的函数），且无论从哪个目录运行脚本（比如在Folder2目录下运行file_5.py）都能正常导入，希望避免使用sys模块。

解决方案 #

1. 给子文件夹添加__init__.py #

在Folder1和Folder2目录下各创建一个空的__init__.py文件，让Python识别它们为PackageName的子包。此时目录结构变为：

├── PackageName    
│   ├── __init__.py (空)   
│   ├── file_1.py  
│   ├── Folder1  
│   │    ├── __init__.py (空)
│   │    ├── file_2.py   
│   │    ├── file_3.py  
│   ├── Folder2  
│   │    ├── __init__.py (空)
│   │    ├── file_4.py   
│   │    ├── file_5.py 

2. 使用绝对导入（以PackageName为根） #

所有导入语句都从包的根目录PackageName开始，示例如下：

• 在file_1.py中：

  from PackageName.Folder2.file_4 import class_4
  

• 在file_5.py或file_3.py中：

  from PackageName.Folder1.file_2 import class_2
  from PackageName.file_1 import class_1
  

3. 确保Python能找到PackageName包 #

要实现任意目录运行都能导入，需要让Python的模块搜索路径包含PackageName的父目录，有两种可靠方式：

方式一：用模块方式运行脚本

从PackageName的父目录（即包含PackageName的那个目录）执行命令，使用-m参数以模块形式运行脚本：

# 运行file_1.py
python -m PackageName.file_1

# 运行Folder2下的file_5.py
python -m PackageName.Folder2.file_5

这种方式会自动把当前目录（PackageName的父目录）加入Python的搜索路径，无需额外配置。

方式二：设置PYTHONPATH环境变量

把PackageName的父目录路径添加到PYTHONPATH环境变量中，这样Python在任何目录下运行时都能找到PackageName包：

• Linux/macOS终端：

  export PYTHONPATH="/path/to/parent-of-PackageName:$PYTHONPATH"
  

• Windows命令提示符：

  set PYTHONPATH=C:\path\to\parent-of-PackageName;%PYTHONPATH%
  

• Windows PowerShell：

  $env:PYTHONPATH = "C:\path\to\parent-of-PackageName;" + $env:PYTHONPATH
  

设置后，无论你cd到哪个目录，直接运行python file_5.py（比如在Folder2目录下）都能正常导入。

关键说明 #

• 根目录的__init__.py无需添加内容，空文件即可；子文件夹的__init__.py同理，仅需存在以标识为子包。
• 不要使用相对导入（如from ..file_1 import ...），相对导入仅适用于以模块方式运行的包内脚本，直接运行脚本时会报错，而绝对导入更稳定通用。
• 避免修改sys.path的原因是硬编码路径会降低代码的可移植性，上述两种方式更符合Python的包管理规范。

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