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