Python项目模块导入疑问：必须用sys.path.append是否正确？

项目目录结构：

├── src/
│   ├── data/
│   │   ├── __init__.py
│   │   └── make_dataset.py
│   │
│   ├── models/
│   │   ├── __init__.py
│   │   └── train_model.py
│   │
│   └── __init__.py
│
└── setup.py

尝试使用from make_dataset import DataCorpusEncoderManager, DataSplitter这类相对导入时提示“找不到make_dataset模块”，添加sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))后可正常导入，但不确定是否必须用这种方式。

不需要依赖sys.path拼接的方式，这属于不规范的临时 workaround，以下是几种更合理的方案：

1. 使用绝对导入（推荐） #

直接基于项目的顶层包src进行导入，比如在src/models/train_model.py中：

from src.data.make_dataset import DataCorpusEncoderManager, DataSplitter

要让这种导入生效，需要确保src所在的根目录（即包含setup.py的目录）被添加到Python的sys.path中，有两种可靠实现方式：

• 设置环境变量：在终端运行脚本前，执行export PYTHONPATH=/path/to/project/root:$PYTHONPATH（Linux/macOS）或set PYTHONPATH=C:\path\to\project\root;%PYTHONPATH%（Windows）
• 可编辑模式安装项目（更推荐）：在项目根目录（含setup.py的目录）执行：

  pip install -e .
  

  这会把项目安装为可编辑模式，Python会自动识别src作为顶层包，无论你在项目哪个位置运行代码，都能正常使用绝对导入。

2. 正确使用相对导入 #

如果一定要用相对导入，需遵循Python包的相对导入规则：

• 从src/models/train_model.py导入data包的模块时，要使用父包的相对路径：

  from ..data.make_dataset import DataCorpusEncoderManager, DataSplitter
  

  注意：相对导入仅在代码作为包的一部分被导入时生效，不能直接运行脚本（比如python src/models/train_model.py会报错，因为此时脚本被当作顶层模块执行，不属于包结构的一部分）。

为什么不推荐sys.path拼接的方式 #

这种硬编码路径的方式存在明显缺陷：

• 路径依赖当前文件的位置，一旦目录结构调整或项目移动到其他环境，代码会直接失效
• 破坏了Python的包管理规范，不利于项目的维护和协作

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