AutoAndroidController/python

python._pth 文件说明

什么是 python._pth 文件？

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

文件作用

1. 配置模块搜索路径 (sys.path)

   • 指定 Python 标准库的位置（如 python313.zip）
   • 指定当前目录（.）用于导入本地模块
   • 指定第三方包目录（如 Lib\site-packages）

2. 启用 site-packages

   • import site 指令会启用 site-packages 目录
   • 这样通过 pip 安装的包才能被正确导入

3. 隔离模式

   • 当存在 ._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 文件所在目录）或绝对路径