核心概念：模块与包
首先，我们得理解两个基本概念：
- 模块 (Module)：一个 .py 文件就是一个模块。
- 包 (Package)：一个包含模块的文件夹。在现代 Python 中，任何文件夹都可以被视为一个包，但包含 init.py 文件是将其明确标记为包的传统方式。
Python 的导入方式归类
所有的导入方式都可以归结为以下几种核心模式和它们的变体。
模式一：导入整个模块 (import module)
这是最基础的导入方式。它将整个模块（文件）加载进来。
- 语法： import 模块名
- 如何使用：在使用模块内的函数或类时，必须在前面加上**"模块名."**作为前缀。
- 通俗比喻：这就像您从仓库拿来一个完整的工具箱。每次要用里面的工具时，您都得先打开工具箱，再说要用哪个工具。
模式二：从模块中导入特定成员 (from module import item)
当您只需要模块中的某一个或几个特定的类、函数或变量时，可以使用这种方式。
- 语法：from 模块名 import 成员1, 成员2, ...
- 如何使用：被导入的成员可以直接使用，无需加任何前缀。
- 通俗比喻：这次您不是拿整个工具箱，而是直接从工具箱里拿出了一把锤子。您可以直接拿起锤子就用，非常方便。
模式三：使用别名 (import ... as ...)
当模块名太长，或者为了遵循社区约定俗成（比如 pandas 和 numpy），我们会给导入的成员起一个更短、更方便的别名。
- 语法：import 模块名 as 别名 或 from 模块名 import 成员 as 别名
- 如何使用：之后的所有调用都必须使用别名，而不是原始名称。
- 通俗比喻：您拿来了一个"超长名字的进口高级工具箱"，但您觉得每次都叫全名太麻烦了，于是您给它贴了个标签，叫 "老王工具箱"。之后您就可以方便地叫它"老王工具箱"了。
关键区别：第三方库 vs. 本地模块
为什么 import pandas 可以，但 import excel_util（一个自己写的模块，位于 myproject/utils/ 目录下）却会报错？
答案在于 Python 的模块搜索路径。Python 解释器在查找模块时，会按顺序检查一系列目录。这个机制可以类比为找书：
- 第三方库 (pandas): 当您通过 pip install pandas 安装时，pandas 被放到了您 Python 环境的 site-packages 目录中。这个目录就像一个全国公共图书馆，Python 解释器天生就知道它的地址，并总是会去那里找书。所以，import pandas 能被轻易找到。
- 本地模块 (excel_util): 这是您自己项目中的一个文件，位于 myproject/utils/ 目录下。它就像一本放在您自家书房某个角落的书。当您在代码中写 import excel_util 时，Python 默认只会在"家门口"（即项目根目录）和"公共图书馆" (site-packages) 寻找。它不会自动深入到您家书房的每一个角落（所有子目录）去找。因此，它找不到 excel_util 并报错。
正确的做法是为本地模块提供一个从"家门口"（项目根目录）开始的完整、清晰的"家庭住址"，这就是绝对导入。
绝对导入 vs. 相对导入
这是导致 ImportError 的核心原因。它关系到 Python 如何"定位"您要的模块。
绝对导入 (Absolute Import)
绝对导入的路径始终从项目的根目录（Sources Root）开始计算。它就像一个完整的、不会出错的家庭住址。
- 特点：以项目根目录下的顶级包名或模块名开始。
- 优点：路径清晰明确，无论当前文件在哪里，这个导入语句的含义都是唯一的。这是官方推荐、也是项目中最常用的方式。
相对导入 (Relative Import)
相对导入的路径是从当前文件所在的位置开始计算的。
- 特点：路径以点 . 或 .. 开始。
- . 代表当前目录。
- .. 代表上一级目录。
- 重要限制：相对导入只能在被当作"包"一部分的模块中使用。如果您直接运行一个包含相对导入的脚本，Python 不知道它的"家"在哪，就会抛出 ImportError。
总结与最佳实践
- 首选绝对导入：在您的项目中，应始终优先使用从根目录开始的绝对导入。
- 合理使用 from ... import ...：当您只需要模块中的少数几个成员时，这是最方便的方式。
- 为长名称或常用库使用别名：import pandas as pd 是必须遵守的社区规范。对于项目内路径很长的模块，也推荐使用别名，如 import infrastructure.utils.excel_util as excel_util。
- 谨慎使用相对导入：只在包内部的模块间相互引用时考虑使用。
- 绝对不要使用 from module import：这种"通配符导入"会污染当前命名空间，很容易造成变量名冲突，让代码变得极难阅读和维护。