Python标准库site——站点专属的配置钩子

• Z时代
• 2024-01-10
• 分类：综合

源代码: Lib/site.py

这个模块将在初始化时被自动导入。 此自动导入可以通过使用解释器的 -S 选项来屏蔽。

导入此模块将会附加域特定的路径到模块搜索路径并且添加一些内建对象，除非使用了 -S 选项。 那样的话，模块可以被安全地导入，而不会对模块搜索路径和内建对象有自动的修改或添加。要明确地触发通常域特定的添加，调用函数 site.main()。

它会从头部和尾部构建至多四个目录作为起点。 对于头部，它会使用 sys.prefix 和 sys.exec_prefix；空的头部会被跳过。 对于尾部，它会使用空字符串然后是 lib/site-packages (在 Windows 上) 或 lib/pythonX.Y/site-packages (在 Unix 和 Macintosh 上)。 对于每个不同的头-尾组合，它会查看其是否指向现有的目录，如果是的话，则将其添加到 sys.path 并且检查新添加目录中的配置文件。

If a file named "pyvenv.cfg" exists one directory above sys.executable,

sys.prefix and sys.exec_prefix are set to that directory and

it is also checked for site-packages (sys.base_prefix and

sys.base_exec_prefix will always be the "real" prefixes of the Python

installation). If "pyvenv.cfg" (a bootstrap configuration file) contains

the key "include-system-site-packages" set to anything other than "false"

(case-insensitive), the system-level prefixes will still also be

searched for site-packages; otherwise they won't.

一个路径配置文件是具有 name.pth 命名格式的文件，并且存在上面提到的四个目录之一中；它的内容是要添加到 sys.path 中的额外项目（每行一个）。不存在的项目不会添加到 sys.path，并且不会检查项目指向的是目录还是文件。项目不会被添加到 sys.path 超过一次。空行和由 # 起始的行会被跳过。以 import 开始的行（跟着空格或 TAB）会被执行。

例如，假设 sys.prefix 和 sys.exec_prefix 已经被设置为 /usr/local。 Python X.Y 的库之后被安装为 /usr/local/lib/pythonX.Y。假设有一个拥有三个孙目录 foo, bar 和 spam 的子目录 /usr/local/lib/pythonX.Y/site-packages，并且有两个路径配置文件 foot.pth 和 bar.pth。假定 foo.pth 内容如下:

# foo package configuration
foo
bar
bletch

并且 bar.pth 包含:

# bar package configuration
bar

则下面特定版目录将以如下顺序被添加到 sys.path。

/usr/local/lib/pythonX.Y/site-packages/bar
/usr/local/lib/pythonX.Y/site-packages/foo

请注意 bletch 已被省略因为它并不存在；bar 目前在 foo 目录之前因为 bar.pth 按字母顺序排在 foo.pth 之前；而 spam 已被省略因为它在两个路径配置文件中都未被提及。

在这些路径操作之后，会尝试导入一个名为 sitecustomize 的模块，它可以执行任意站点专属的定制。 它通常是由系统管理员在 site-packages 目录下创建的。 如此此导入失败并引发 ImportError 或其子类异常，并且异常的 name 属性等于 'sitecustomize'，则它会被静默地忽略。 如果 Python 是在没有可用输出流的情况下启动的，例如在 Windows 上使用 pythonw.exe (它默认被用于启动 start IDLE)，则来自 sitecustomize 的输出尝试会被忽略。 任何其他异常都会导致静默且可能令人迷惑不解的进程失败。

在此之后，会尝试导入一个名为 usercustomize 的模块，它可以执行任意用户专属的定制，如果 ENABLE_USER_SITE 为真值的话。 这个文件应该在用户的 site-packages 目录中创建（见下文），该目录是 sys.path 的组成部分，除非被 -s 所禁用。 如果此导入失败并引发 ImportError 或者其子类异常，并且异常的 name 属性等于 'usercustomize'，它会被静默地忽略。

请注意对于某些非 Unix 系统来说，sys.prefix 和 sys.exec_prefix 均为空值，并且路径操作会被跳过；但是仍然会尝试导入 sitecustomize 和 usercustomize。

$python3 -m site --user-site
/home/user/.local/lib/python3.3/site-packages