Инициализация пути поиска модулей 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.