### Python 中 library 的引用路径逻辑与 sys.path 配置 在 Python 中，`import` 语句用于加载模块或库。其搜索顺序与 `sys.path` 密切相关，`sys.path` 是一个包含多个路径的列表，Python 解释器会按照该列表中的顺序逐一查找目标模块或库[^1]。 #### sys.path 的组成 `sys.path` 的内容由以下几个部分构成： 1. **脚本运行目录**：当直接运行一个脚本时（例如 `python script.py`），脚本所在的目录会被添加到 `sys.path` 的第一位[^4]。 2. **标准库路径**：Python 安装时自带的标准库路径，例如 `/Library/Frameworks/Python.framework/Versions/3.9/lib/python3.9/`[^2]。 3. **site-packages 路径**：虚拟环境中安装的第三方库路径，例如 `E:\\Anaconda3\\envs\\pytorch17\\lib\\site-packages`[^1]。 4. **其他路径**：用户通过环境变量 `PYTHONPATH` 或动态修改 `sys.path` 添加的路径[^3]。 #### 搜索顺序 当执行 `import module` 时，Python 解释器会按照 `sys.path` 列表中的顺序逐一查找模块文件。如果找到匹配的模块，则停止搜索并加载；如果没有找到，则抛出 `ModuleNotFoundError` 异常。 #### 动态配置 sys.path 用户可以通过以下方式动态调整 `sys.path` 的内容： 1. **使用环境变量**：设置 `PYTHONPATH` 环境变量，将指定路径添加到 `sys.path` 中。 2. **代码中修改**：通过 Python 代码动态调整 `sys.path`，例如： ```python import sys import os # 获取当前脚本所在目录 current_dir = os.path.dirname(os.path.abspath(__file__)) # 将当前目录添加到 sys.path sys.path.append(current_dir) ``` 上述代码将当前脚本所在的目录添加到 `sys.path` 中，从而可以导入该目录下的模块[^3]。 #### python -m 命令的影响 使用 `python -m` 命令运行模块时，`sys.path[0]` 并不是脚本所在的目录，而是命令执行所在的目录。这使得 `python -m` 成为一种方便的方式，能够在 `sys.path` 中搜索模块而无需明确指定路径[^4]。 ```python # 示例：假设 mod.py 文件位于 sys.path 中的某个路径 python -m mod ``` 上述命令会自动在 `sys.path` 中搜索 `mod.py` 并执行。 ### 注意事项 - 如果需要引用相对路径的模块，建议使用 `os` 模块获取当前路径，并将其添加到 `sys.path` 中[^3]。 - 在虚拟环境中，`sys.path` 会优先包含虚拟环境的 `site-packages` 路径，因此可以避免与其他环境的模块冲突。