Python中绝对导入与相对导入的对比及适用场景详解

一、核心概念

1. 绝对导入（Absolute Import）

from package.subpackage.module import function

# 项目结构：myapp/utils/logger.py
from myapp.utils.logger import setup_logger  # 绝对导入

2. 相对导入（Relative Import）

from .sibling_module import func    # 同级模块
from ..parent_module import Class   # 上级目录模块

# 项目结构：myapp/models/user.py
from .database import Database  # 导入同级模块
from ..utils.logger import setup_logger  # 导入上级目录模块

二、关键区别

三、适用场景

1. 绝对导入的适用场景

from myapp.core.database import connect

from flask import Flask

2. 相对导入的适用场景

# 文件：myapp/models/user.py
from .role import Role  # 导入同级模块
from ..utils.validators import validate_email  # 导入上级目录模块

四、常见错误与解决方法

1. 相对导入错误：ImportError: attempted relative import with no known parent package

python -m myapp.models.user

2. ModuleNotFoundError

(1).项目根目录未在 Python 路径（sys.path）中，例如下面的原因三，进入子目录后运行主程序（Python在运行时，会将当前目录加入到 sys.path，而不是主程序所在的目录）。

(2).直接运行子模块（直接运行一个子模块作为主程序时，Python可能无法识别相对导入，因为此时该模块的__name__不是包的一部分，而是__main__。这时候就需要用绝对导入，或者调整运行方式，比如使用-m参数。），子模块中使用相对路径导入其他模块。

(3).在子目录中运行主程序，例如进入子目录下，然后运行 python ../main.py，这个时候，当前工作目录会是 子目录，而不是main.py所在的目录。

import sys, os
sys.path.append(os.path.dirname(os.path.abspath(__file__)))

五、最佳实践

1. 优先使用绝对导入：提升代码可读性和可维护性，尤其在大型项目中。

2. 限制相对导入范围：仅在包内部模块间使用，避免跨包或顶层脚本中使用。

3. 统一代码风格：

4. 绝对导入：from package.module import func

5. 相对导入：from .submodule import Class

6. 正确配置包结构：

7. 确保每个目录包含 __init__.py（Python 3.3+ 可隐式存在，但显式声明更清晰）。

8. 通过 setup.py 或 pyproject.toml 定义包依赖。

六、示例对比

项目结构

复制

myproject/
├── app/
│   ├── __init__.py
│   ├── core/
│   │   ├── __init__.py
│   │   ├── database.py
│   │   └── models.py
│   └── utils/
│       ├── __init__.py
│       └── logger.py
└── main.py

导入方式

1. 绝对导入（在 main.py 中）：

   from app.core.database import connect
   from app.utils.logger import setup_logger

2. 相对导入（在 app/core/models.py 中）：

   from .database import connect  # 导入同级模块
   from ..utils.logger import setup_logger  # 导入上级目录模块

总结

作者：yaoshengting