python导入模块时按sys.path顺序查找首个匹配项；该路径由脚本目录、pythonpath、标准库路径、site-packages等组成，可动态修改，虚拟环境会优先插入其site-packages并屏蔽系统包。
Python 导入模块时，会按 sys.path 中的路径顺序逐个查找，找到第一个匹配的模块即停止。这个列表不是固定不变的，而是由解释器启动时自动构建、并可在运行时动态修改的搜索路径集合。
sys.path 的默认组成来源
解释器启动时，sys.path 通常包含以下几类路径（顺序很重要）：
- 脚本所在目录（空字符串
''表示当前工作目录，若直接运行脚本则为该脚本所在路径） - 环境变量
PYTHONPATH指定的路径（多个路径用:或;分隔） - 标准库安装路径（如
/usr/lib/python3.x/或C:\Python3x\Lib\） - 第三方包安装路径（如
site-packages目录，包括通过pip install安装的包）
如何查看和临时修改 sys.path
在 Python 交互式环境或脚本中可直接访问：
查看当前路径：import sys; print(sys.path)
临时添加路径（仅对当前进程有效）：
Python 3.14.2
下载
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
-
sys.path.append('/path/to/my/modules')—— 添加到末尾（优先级最低） -
sys.path.insert(0, '/path/to/my/modules')—— 添加到开头（优先级最高，可能覆盖同名标准模块）
注意：不推荐长期用 insert(0)，容易引发模块冲突或隐藏问题。
site-packages 与用户站点包（user site-packages）
通过 pip install --user 安装的包会放入用户站点目录（如 ~/.local/lib/python3.x/site-packages），该路径默认包含在 sys.path 中，但需满足：
- 环境变量 PYTHONNOUSERSITE 未设为非空值
- 解释器未启用 -s（禁用 site 模块）参数
可通过 python -m site --user-site 查看用户站点路径。
虚拟环境如何影响 sys.path
激活虚拟环境后，sys.path 会发生明显变化：
- 开头新增虚拟环境的
site-packages路径 - 原系统
site-packages默认被屏蔽（除非创建时加--system-site-packages） - 标准库路径仍保留，但指向虚拟环境内的副本（实际是符号链接或独立拷贝）
这意味着同一份代码在不同虚拟环境中，可能导入完全不同的同名包版本。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
