嵌套项目或自建库中Python模块导入问题及简化方法问询

1. 用相对导入处理包内模块调用 #

在包内部的模块中，使用相对导入语法，无需关注外部运行环境：

• 同目录模块：from . import my_module_2
• 上级目录模块：from ..dir_lv1 import module_lv1

注意：相对导入仅在模块被当作包的一部分导入时生效，直接运行该模块（如python module_lv2.py）会报错，需配合其他方法解决。

2. 把项目根目录加入Python路径（通用解决方案） #

确保项目根目录在sys.path中，就能用基于根目录的绝对导入，所有场景下导入语句统一。

两种实现方式： #

• 代码内动态添加路径
  在需要单独运行的模块开头加入以下代码（根据实际目录层级调整parent的次数）：

import sys
from pathlib import Path

# 获取项目根目录（假设main.py所在目录为根）
root_dir = Path(__file__).resolve().parent.parent.parent
if str(root_dir) not in sys.path:
    sys.path.append(str(root_dir))

之后即可用绝对导入，比如from dir_lv1.dir_lv2 import module_lv2，无论直接运行模块还是从main.py启动都有效。

• 设置系统环境变量（推荐长期使用）
  配置PYTHONPATH环境变量，值为项目根目录路径，Python会自动识别该路径：
  • Windows终端：set PYTHONPATH=C:\your\project\root
  • Linux/macOS终端：export PYTHONPATH=/your/project/root

3. 用打包工具规范自建库导入 #

如果是要打包成库的项目，在根目录创建setup.py或pyproject.toml，声明包结构：
示例setup.py内容：

from setuptools import setup, find_packages

setup(
    name="lib_dir",
    version="0.1.0",
    packages=find_packages()
)

本地开发时运行pip install -e .，即可直接用from lib_dir import my_module_2导入，和打包安装后的导入语句完全一致，无需修改代码。

4. 规范运行入口（减少场景冲突） #

项目开发中尽量以main.py作为唯一运行入口，子模块仅作为被导入的组件。若需测试子模块，可使用模块运行方式：

python -m dir_lv1.dir_lv2.module_lv2

这种方式会自动将项目根目录加入sys.path，支持相对和绝对导入。

内容的提问来源于stack exchange，提问作者Paweł Pietraszko