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