核心原则

在Python中有效地管理包和模块导入，遵循以下可确保代码的组织性、可读性和可维护性：

1. 项目结构规划：项目应采用清晰的层次化结构，其中入口脚本所在的目录应仅包含一个主包（目录），所有自定义包和模块均在该主包之下。这样设计有利于模块间相互引用和理解项目结构。

2. 入口脚本导入策略：当编写直接作为程序入口的脚本时，推荐使用绝对导入。例如，from my_package.module import function。这样做确保了即使脚本独立运行，也能正确解析模块路径，避免因相对导入引起的潜在错误。

3. 内部模块间的相对导入：在包内部的模块中，鼓励使用相对导入来提高代码的内聚性和清晰度。例如，在my_package.subpackage1中引用同级模块可以写作from .module1 import function，引用上级模块则为from ..module import function。

4. 包标识：每个包目录下应包含一个__init__.py文件（或在Python 3.3+中为任意非空文件），这是Python识别该目录为包的关键。虽然在新版本中此文件可以为空，但通常建议至少包含一些包级别的初始化代码或导出控制语句。

5. 利用python -m执行子模块：若需将包内的某个模块作为单独的入口点执行，推荐使用python -m package.submodule命令。这种方式能够正确设置模块的搜索路径，确保相对导入按预期工作，因为它模拟了模块的正常导入过程，而非直接执行脚本文件。

遵循上述原则，可以构建出结构清晰、易于管理和扩展的Python项目，同时保证导入机制的稳定性和一致性。

Python项目目录结构

基于上述总结的原则，一个典型的Python项目目录结构可以如下所示：

my_project/
│
├── main.py          # 入口脚本，使用绝对导入
│
├── my_package/      # 主包目录
│   ├── __init__.py   # 包初始化文件
│   │
│   ├── subpackage1/    # 子包1
│   │   ├── __init__.py
│   │   ├── module1.py
│   │
│   ├── subpackage2/    # 子包2
│   │   ├── __init__.py
│   │   ├── module2.py
│   │
│   ├── utilities/       # 工具模块子包
│   │   ├── __init__.py
│   │   ├── helper.py
│   │
│   └── core.py         # 主包内的核心模块
│
└── README.md        # 项目说明文档

在这个结构中：

• main.py 作为程序的入口点，使用绝对导入来引用 my_package 内的模块和子包。
• my_package 是主包，包含了子包和模块。每个子包和模块都可以通过绝对或相对导入来引用彼此，遵循了上述的导入原则。
• subpackage1, subpackage2, 和 utilities 是子包，各自拥有自己的模块和可能的进一步子结构。
• core.py 是直接位于主包内的模块，可以被包内其他部分直接引用。
• README.md 提供项目的基本信息和使用指南。

这样的结构不仅便于组织和维护代码，还确保了导入机制的高效和一致性，符合Python的最佳实践。

参考资料

Python 3.11.8 Documentation » Python 教程 » 6. 模块 » 6.4.2. 相对导入