python._pth 文件说明

什么是 python._pth 文件？

python._pth 是 Python embeddable（嵌入式/便携版）Python 的配置文件，用于控制 Python 解释器的模块搜索路径。

文件作用

配置模块搜索路径 (sys.path)
- 指定 Python 标准库的位置（如 python313.zip）
- 指定当前目录（.）用于导入本地模块
- 指定第三方包目录（如 Lib\site-packages）
启用 site-packages
- import site 指令会启用 site-packages 目录
- 这样通过 pip 安装的包才能被正确导入
隔离模式
- 当存在 ._pth 文件时，Python 会进入"隔离模式"
- 忽略系统环境变量和用户 site-packages
- 只使用 ._pth 文件中指定的路径

当前配置

python313.zip          # Python 标准库压缩包
.                       # 当前目录（python 文件夹）
Lib\site-packages       # 第三方包安装目录
import site             # 启用 site-packages，让 pip 安装的包可以被导入

文件位置

文件路径：python\python._pth
必须与 python.exe 在同一目录下

注意事项

如果删除此文件，Python 将使用默认的系统路径配置
修改此文件后，需要重启 Python 才能生效
路径可以使用相对路径（相对于 ._pth 文件所在目录）或绝对路径