sys.path是Python模块搜索路径列表，按顺序查找模块；其初始内容包括脚本所在目录（空字符串表示）、PYTHONPATH、标准库及第三方包路径；可安全用insert或append修改，但生产环境推荐可编辑安装。
Python 导入模块时，不是随便在哪都能找到的——它有一套明确的搜索路径规则，核心就是 sys.path 这个列表。理解它，才能搞懂为什么有些 import 成功、有些报 ModuleNotFoundError，也能灵活调整模块加载行为。
sys.path 是什么？
sys.path 是一个由字符串组成的 Python 列表，每个字符串代表一个文件系统路径。Python 解释器在执行 import 语句时，会**按顺序**遍历这个列表里的每一个目录，查找匹配的模块（.py 文件）或包（含 __init__.py 的目录）。
你可以随时查看当前的搜索路径：
import sys print(sys.path)
sys.path 的初始内容从哪来？
解释器启动时，sys.path 会自动初始化，来源包括（按典型优先级顺序）：
huaweicloud-python-sdk-helper
下载
华为云 Python SDK 查询工具。自动发现已安装 SDK 的服务包、Client类、API 方法、入参详情、类信息（__init__ 参数、属性、类型、描述），支持关键字搜索，快速定位目标 API 使用方法。
立即学习“Python免费学习笔记（深入）”；
- 运行脚本所在目录（空字符串
''表示当前工作目录，排第一） - 环境变量
PYTHONPATH中列出的路径（如果设置了） - 标准库安装路径（如
/usr/lib/python3.x/或C:\Python3x\Lib\） - 第三方包安装路径（如
site-packages目录）
注意：空字符串（''）不是“没路径”，而是代表当前工作目录（os.getcwd()），且它永远排在最前面——这也是为什么在同一目录下写两个 .py 文件，直接 import 就能成功。
如何安全地修改 sys.path？
不推荐硬编码修改，但有时确实需要（比如项目结构复杂、测试时临时加路径）。常用做法是：
- 用
sys.path.insert(0, '/path/to/your/module')插入到最前（最高优先级） - 用
sys.path.append('/path/to/your/module')加到末尾（最低优先级） - 插入前建议先检查路径是否存在、是否为目录：
os.path.isdir(path) - 生产环境更推荐用
pip install -e .（可编辑安装）或配置pyproject.toml，而非手动改sys.path
常见误区与排查技巧
遇到 import 失败，别急着改代码，先查路径逻辑：
-
当前工作目录 ≠ 脚本所在目录：用
python /abs/path/to/script.py运行时，sys.path[0]是你执行命令时所在的目录，不是 script.py 所在目录 -
相对导入只在包内有效：单独运行一个
__init__.py或子模块会失败，因为解释器不认为它属于某个包 - 打印
sys.path+os.getcwd()+os.path.dirname(__file__)三者，基本能定位路径混乱根源
