Python导入模块时按顺序查找：当前目录、PYTHONPATH路径、标准库、site-packages；2. 可通过sys.path查看和动态修改搜索路径；3. 常见导入错误多因路径问题，建议检查文件名、使用虚拟环境、避免同名模块冲突。
当你在Python中使用import语句导入模块时，解释器会按照一定的顺序查找模块的位置。这个过程是自动进行的，但理解其机制有助于解决导入错误和管理项目结构。
模块搜索路径的组成
Python解释器在导入模块时，会依次搜索以下位置：
- 当前运行脚本所在的目录：这是优先级最高的位置。即使你的模块在标准库或已安装包中存在，Python也会先检查当前目录。
- 环境变量PYTHONPATH指定的目录：这是一个可选配置，你可以将自定义路径添加到这里，让Python在这些目录中查找模块。
- Python安装路径下的标准库目录：包括内置模块（如os、sys）和随Python一起发布的库。
- 第三方包安装目录（site-packages）：通过pip安装的包通常位于这里。具体路径取决于操作系统和是否使用虚拟环境。
查看实际的搜索路径
你可以通过sys.path查看Python当前的模块搜索路径列表：
for path in sys.path:
print(path)
这个列表是一个有序的目录集合，Python按顺序查找，一旦找到匹配的模块就停止搜索。注意，第一个元素通常是空字符串，代表当前目录。
立即学习“Python免费学习笔记（深入）”；
如何动态修改搜索路径
如果需要临时添加模块路径，可以在导入前操作sys.path：
sys.path.append('/your/custom/module/path')
也可以使用相对或绝对路径插入到特定位置。但要注意避免重复添加，以免影响性能或引发冲突。更推荐的做法是使用虚拟环境或正确配置PYTHONPATH。
常见问题与建议
模块找不到（ModuleNotFoundError）通常是因为路径未包含在sys.path中。建议：
- 确认模块文件名拼写正确，且包含
.py扩展名。 - 确保目标目录中包含
__init__.py文件（对于包而言，Python 3.3+可省略，但显式声明更清晰）。 - 使用虚拟环境管理依赖，避免路径混乱。
- 避免在多个位置放置同名模块，防止意外导入错误版本。
基本上就这些。理解Python如何定位模块能帮你更高效地组织代码和排查问题。不复杂但容易忽略。
