Python导入模块时按顺序搜索路径：先当前脚本目录，再PYTHONPATH环境变量指定的目录，最后是安装默认路径如标准库和site-packages。可通过sys.path查看当前搜索路径列表，其顺序决定模块查找优先级。使用sys.path.insert(0, 'path')可临时添加高优先级路径，append则添加低优先级路径，.pth文件或PYTHONPATH实现持久配置。若自定义模块与标准库同名（如json.py），会因搜索顺序导致“模块遮蔽”，误加载本地文件而非标准库，引发错误。因此应避免命名冲突，以确保正确导入。
Python在导入模块时，会按照一定的路径顺序查找模块。了解这些路径和搜索顺序，有助于我们更好地组织项目结构、避免导入错误，以及理解第三方库是如何被加载的。
模块搜索路径来源
Python在导入一个模块时，会依次从以下几个位置查找：
- 当前执行脚本所在的目录：这是最高优先级的位置。无论你从哪里运行脚本，Python都会把该脚本所在目录加入搜索路径。
- 环境变量 PYTHONPATH 中指定的目录：这是一个可选的环境变量，可以包含多个目录路径，Python会按顺序搜索这些路径中的模块。
- Python安装时的默认路径：包括标准库路径、site-packages 目录等。这些路径通常位于 Python 安装目录下，比如 lib、lib/site-packages 等。
查看当前模块搜索路径
你可以通过 sys.path 查看 Python 当前的模块搜索路径列表：
import sysfor path in sys.path:
print(path)
输出结果是一个字符串列表，Python 就是按这个列表的顺序从上到下查找模块的。
立即学习“Python免费学习笔记（深入）”；
修改模块搜索路径
如果需要临时添加自定义路径，可以在导入前使用 sys.path.insert() 或 sys.path.append()：
小生淘宝客程序打折程序
下载
淘宝客打折系统，集成了jssdk模块，增加了seo优化功能，更有利于搜索引擎收录 1程序上传到服务器空间 2开启服务器 3打开安装地址：http://您的域名/install.php 4如果不能安装请确保数据库里的表全部删除 5进入后台地址：http://您的域名/main.php 默认用户名和密码都是admin 6测试数据时可以导入 test文件夹里的test.sql文件 到数据库，或者
sys.path.insert(0, '/your/custom/module/path') # 插入到最前面，优先级最高
注意：插入到索引 0 位置会使该路径最先被搜索，适用于优先加载本地模块；追加则放在末尾，适合作为后备路径。
另一种方式是使用 .pth 文件或设置 PYTHONPATH 环境变量，实现更持久的路径配置。
搜索顺序的实际影响
由于搜索是按顺序进行的，可能会出现“模块遮蔽”问题。例如：
- 项目中有一个叫 json.py 的文件，与标准库 json 同名。
- 当你执行 import json 时，Python 会先找到你写的 json.py，而不是标准库。
- 这可能导致意外行为，甚至报错（如循环导入或缺少属性）。
因此，避免使用与标准库或第三方库重名的模块名。
基本上就这些。理解搜索路径机制，能帮助你更清楚地掌控模块导入过程，减少奇怪的导入问题。
