Инициализация пути поиска модулей sys.path

Путь поиска модулей инициализируется при запуске Python. К этому пути поиска модулей можно обратиться через sys.path.

Первым элементом пути поиска модулей является каталог, содержащий входной скрипт, если он есть. В противном случае первым элементом будет текущий каталог — так происходит при запуске интерактивной оболочки, команды -c или модуля -m.

Переменная среды PYTHONPATH часто используется для добавления каталогов в путь поиска. Если эта переменная среды задана, её содержимое добавляется в путь поиска модулей.

Затем добавляются каталоги со стандартными модулями Python, а также любые модули расширения, от которых зависят эти модули. Модули расширения — это файлы .pyd в Windows и файлы .so на других платформах. Каталог с платформонезависимыми модулями Python называется prefix. Каталог с модулями расширения называется exec_prefix.

Переменную среды PYTHONHOME можно использовать, чтобы задать расположение prefix и exec_prefix. В противном случае эти каталоги находятся относительно исполняемого файла Python: поиск начинается с него и продолжается по различным файлам и каталогам-«ориентирам». Обратите внимание, что символические ссылки отслеживаются, поэтому поиск начинается от фактического расположения исполняемого файла Python. Расположение исполняемого файла Python называется home.

После определения home каталог prefix находится путем поиска pythonmajorversionminorversion.zip (python311.zip). В Windows zip-архив ищется в home, а в Unix ожидается, что он находится в lib. Обратите внимание, что ожидаемое расположение zip-архива добавляется в путь поиска модулей, даже если архив не существует. Если архив не найден, Python в Windows продолжит поиск prefix, выполнив поиск Lib\os.py. Python в Unix выполнит поиск lib/pythonmajorversion.minorversion/os.py (lib/python3.11/os.py). В Windows prefix и exec_prefix совпадают, однако на других платформах выполняется поиск lib/pythonmajorversion.minorversion/lib-dynload (lib/python3.11/lib-dynload), который используется как точка отсчёта для exec_prefix. На некоторых платформах lib может иметь значение lib64 или другое значение; см. sys.platlibdir и PYTHONPLATLIBDIR.

После обнаружения prefix и exec_prefix доступны соответственно через sys.prefix и sys.exec_prefix.

Наконец, обрабатывается модуль site, а в путь поиска модулей добавляются каталоги site-packages. Распространённый способ настройки пути поиска — создание модулей sitecustomize или usercustomize, как описано в документации модуля site.