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