sys.path初始内容来自运行脚本目录或当前工作目录、PYTHONPATH环境变量、标准库路径及site-packages等；可通过sys.path查看和临时修改，永久添加推荐用.pth文件、PYTHONPATH或虚拟环境。
Python 包的查找路径由 sys.path 决定，它是一个字符串列表，Python 按顺序从中搜索模块和包。
sys.path 的初始内容从哪里来？
Python 启动时会按以下顺序构建 sys.path：
- 运行脚本所在目录（如果是直接执行 Python 文件）或当前工作目录（如果是交互式启动且未指定脚本）
-
PYTHONPATH环境变量中列出的目录（若有，以:或;分隔） -
标准库安装路径（如
lib/python3.x/）和内置模块位置 - 第三方包安装路径，例如
site-packages目录（通过site模块自动添加）
如何查看和临时修改 sys.path？
在 Python 中可直接访问和操作：
- 查看：执行
import sys; print(sys.path) - 临时添加：用
sys.path.append('/your/path')或sys.path.insert(0, '/your/path')（插在开头优先匹配） - 注意：这种修改只对当前解释器会话有效，重启即失效
永久添加路径的常用方式
不建议直接改 sys.path，更可靠的方式有：
立即学习“Python免费学习笔记（深入）”；
- 把包放在
site-packages中（如用pip install -e .安装开发版） - 创建
.pth文件：在某个site-packages目录下新建文本文件，每行写一个绝对路径，Python 会自动读取 - 设置
PYTHONPATH环境变量（适合开发调试，但生产环境慎用） - 使用虚拟环境隔离依赖，避免路径冲突
包导入时的实际查找逻辑
当你执行 import foo 或 from bar import baz 时：
- Python 遍历
sys.path中每个目录 - 在该目录下依次尝试查找：
foo.py、foo/__init__.py、foo.so、foo.pyd等可导入对象 - 找到第一个匹配项即停止搜索并加载，后续同名路径不会生效
- 因此路径顺序很重要，靠前的目录具有更高优先级
理解 sys.path 的构成和控制方式，能帮你准确定位导入失败原因，也便于组织项目结构和管理依赖。
