.pth文件解析器如何区分路径行与Python代码行？是否有官方规范？

问题背景 #

.pth文件可同时包含需添加至sys.path的路径（文件夹或ZIP文件）与Python代码（如import语句）。例如pywin32.pth的内容：

# .pth file for the PyWin32 extensions
win32
win32\lib
Pythonwin
# And some hackery to deal with environments where the post_install script
# isn't run.
import pywin32_bootstrap

核心疑问：解析器如何区分路径行与Python代码行？

附加疑问：

1. Python的.pth文件是否有官方规范？（已查阅site模块相关文档，但信息不够完整）
2. .pth文件似乎也支持ZIP文件路径，比如嵌入式Python的python38._pth：

python38.zip
.

# Uncomment to run site.main() automatically
#import site

解答 #

路径与代码行的区分逻辑 #

Python的site模块负责解析.pth文件，区分规则如下：

• 首先跳过空行和以#开头的注释行
• 对剩余的每一行：
  1. 尝试将该行作为Python代码通过exec()执行
  2. 若执行无错误，则视为代码行处理（直接运行代码）
  3. 若执行报错（比如纯路径字符串不符合Python语法），则视为路径行：将路径解析为绝对路径，若路径存在则添加到sys.path中

举个实际例子：import pywin32_bootstrap是合法Python代码，执行成功，因此会被当作代码运行；而win32作为单独的裸字符串，直接执行会触发语法错误，因此被识别为路径添加到sys.path。

关于官方规范 #

.pth文件没有独立的官方规范文档，其行为完全由site模块的实现定义。官方仅在site模块文档中提及.pth文件的基本用途，更细节的规则需查看CPython源码中的site.py文件。

另外，嵌入式Python使用的._pth文件是特殊变体：它的处理逻辑更简化，默认不加载site模块，仅将列出的路径添加到sys.path，注释行和被注释的代码行（如#import site）会直接被跳过。

内容的提问来源于stack exchange，提问作者Basj