Развертывание Python 3.12 на Windows и его настройка

Расширенные примеры настройки Python 3.12 в Windows

Автоматическая установка Python через PowerShell с регистрацией в PATH для всех пользователей

Следующий сценарий загружает установщик, устанавливает его с опцией «InstallAllUsers» и добавляет пути в глобальную переменную PATH:

$installerUrl = "https://www.python.org/ftp/python/3.12.0/python-3.12.0-amd64.exe"
$installerPath = "$env:TEMP\python-3.12.0-amd64.exe"
Invoke-WebRequest -Uri $installerUrl -OutFile $installerPath
Start-Process -FilePath $installerPath -ArgumentList "/quiet InstallAllUsers=1 PrependPath=1" -Wait
# Перезагрузка переменной PATH в текущей сессии
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
python --version

Python 3.12.0

Пояснение: ключ /quiet подавляет интерфейс установщика, InstallAllUsers=1 устанавливает Python для всех пользователей (требует прав администратора), PrependPath=1 добавляет пути в системную переменную PATH.

Создание виртуального окружения с предустановленными пакетами (requirements.txt)

# Создать каталог проекта
mkdir C:\projects\myapp
cd C:\projects\myapp
# Создать виртуальное окружение
python -m venv venv
# Активировать
venv\Scripts\activate
# Установить пакеты из файла
pip install -r requirements.txt
# Деактивировать
deactivate

Содержимое requirements.txt:

requests==2.31.0
flask==3.0.0
numpy==1.26.2

Результат: изолированная среда с определёнными версиями библиотек.

Использование менеджера версий Python py.exe (Python Launcher)

Python Launcher (py.exe) устанавливается вместе с официальным установщиком и позволяет выбирать версию Python при запуске скриптов.

# Показать список установленных версий
py -0
# Запустить скрипт на Python 3.12
py -3.12 script.py
# Установить пакет для версии 3.12
py -3.12 -m pip install requests

Installed Python versions:
 -3.12-64 *
 -3.11-64

Пояснение: символ * обозначает версию по умолчанию.

Добавление дополнительных путей поиска модулей через .pth файл

Файлы с расширением .pth в директории site-packages позволяют добавить кастомные пути в sys.path без изменения кода.

# Определить директорию site-packages
python -c "import site; print(site.getsitepackages()[0])"
# Результат: C:\Users\Имя\AppData\Local\Programs\Python\Python312\Lib\site-packages
# Создать файл mypaths.pth в этой директории с содержимым:
C:\Users\Имя\my_modules
# После этого модули из папки my_modules станут доступны для импорта

Проверка:

python -c "import sys; print('C:\\Users\\Имя\\my_modules' in sys.path)"

True

Установка пакетов pip из локального офлайн-репозитория

В окружениях без доступа к интернету пакеты можно заранее скачать на одной машине, а затем установить на других.

# На машине с интернетом: сохранить пакеты в архив
pip download -d C:\offline_packages requests flask
# Перенести папку offline_packages на целевую машину
# Установить из локальной папки
pip install --no-index --find-links C:\offline_packages requests flask

Результат: пакеты устанавливаются без обращения к сети.

Настройка переменной среды PYTHONPATH для автоматического импорта

Переменная PYTHONPATH указывает дополнительные директории, которые Python добавляет в sys.path при запуске.

# Добавить через командную строку (текущая сессия)
set PYTHONPATH=C:\my_libs
# Добавить навсегда через setx
setx PYTHONPATH "C:\my_libs"
# Проверить
python -c "import sys; print(sys.path)"

Результат: путь C:\my_libs появится в списке sys.path.