Выполнение Python скриптов в операционной системе Windows

Раздел содержит расширенные примеры выполнения кода Python в Windows, включая работу с несколькими версиями, виртуальным окружением, планировщиком и службой NSSM.

Список установленных версий Python

Команда py -0 выводит таблицу доступных интерпретаторов:

py -0

Installed Pythons found by py Launcher for Windows
 -3.12-64        C:\Python\312\python.exe
 -3.11-64        C:\Python\311\python.exe
 -3.9-64         C:\Python\39\python.exe

Флаг -0p добавляет полные пути:

py -0p

 -3.12-64        C:\Python\312\python.exe *
 -3.11-64        C:\Python\311\python.exe
 -3.9-64         C:\Python\39\python.exe

Звездочка показывает версию по умолчанию. Запуск конкретной версии выполняется так:

py -3.9 C:\scripts\legacy.py

Такой способ обеспечивает обратную совместимость, когда устаревший код не работает с новой версией.

Создание виртуального окружения и установка зависимостей

cd C:\scripts\myproject
py -3.12 -m venv .venv
.venv\Scripts\python.exe -m pip install --upgrade pip
.venv\Scripts\python.exe -m pip install -r requirements.txt

После установки зависимостей список пакетов выводится командой:

.venv\Scripts\python.exe -m pip freeze

beautifulsoup4==4.12.3
requests==2.31.0

Запуск основного модуля проекта:

.venv\Scripts\python.exe -m app.main --config config.yaml

Виртуальное окружение изолирует библиотеки и не изменяет глобальный интерпретатор Windows.

Проверка кода завершения в пакетном файле

Пакетный файл может останавливаться при ошибке или продолжать работу. Пример с проверкой уровня ошибки:

@echo off
set PYTHONUTF8=1
set PYTHONPATH=C:\scripts\myproject
"C:\scripts\.venv\Scripts\python.exe" "C:\scripts\myproject\worker.py" --mode daily
if errorlevel 1 (
    echo Worker stopped with error code %ERRORLEVEL%
    exit /b %ERRORLEVEL%
)
echo Worker finished successfully

В PowerShell аналогичная проверка выглядит так:

$env:PYTHONUTF8 = "1"
$env:PYTHONPATH = "C:\scripts\myproject"
$p = Start-Process -FilePath "C:\scripts\.venv\Scripts\python.exe" -ArgumentList "C:\scripts\myproject\worker.py", "--mode", "daily" -Wait -PassThru
if ($p.ExitCode -ne 0) { Write-Error "Exit code $($p.ExitCode)" }

Использование Start-Process позволяет получить объект процесса и его код завершения.

Запуск модуля http.server на выбранном порту

Встроенный модуль http.server часто используется для быстрой раздачи файлов по локальной сети:

python -m http.server 8080 --bind 127.0.0.1 --directory C:\Shared

Вывод при успешном запуске:

Serving HTTP on 127.0.0.1 port 8080 (http://127.0.0.1:8080/) ...

Для завершения работы используется Ctrl+C.

Запуск с оптимизацией и без байткода

Интерпретатор Python поддерживает флаги, изменяющие режим выполнения. Флаг -O убирает assert-проверки:

python -O C:\scripts\app.py

Флаг -B отключает запись .pyc файлов:

python -B C:\scripts\app.py

Флаг -u включает небуферизованный вывод:

python -u C:\scripts\logger.py

Комбинация флагов допустима:

python -O -B -u C:\scripts\app.py

Такие режимы полезны для временного запуска, когда не требуется создание кэша или когда важна своевременная запись логов.

Переменные окружения и рабочий каталог

Для Windows переменные окружения задаются в командной строке через set:

set PYTHONUTF8=1
set PYTHONDONTWRITEBYTECODE=1
python C:\scripts\app.py

В PowerShell синтаксис отличается:

$env:PYTHONUTF8 = "1"
$env:PYTHONDONTWRITEBYTECODE = "1"
python C:\scripts\app.py

Рабочий каталог влияет на поиск файлов. Запуск с явной сменой каталога в cmd:

cd /d C:\scripts\project
python app.py

В PowerShell:

Set-Location C:\scripts\project
python app.py

Относительные пути в скрипте считаются от текущего каталога процесса, а не от местоположения файла скрипта. Для получения каталога самого скрипта внутри Python используется Path(__file__).resolve().parent.

Запуск планировщика заданий через schtasks

Создание ежедневного задания с указанием рабочих параметров:

schtasks /Create /F /TN "Admin\Python Report" /TR \"C:\Python\312\python.exe\" \"C:\Scripts\report.py\" /SC DAILY /ST 09:30 /RU SYSTEM

После создания задание можно проверить:

schtasks /Query /TN "Admin\Python Report" /V /FO LIST

Folder: Admin
TaskName: Admin\Python Report
Status: Ready
Schedule Type: Daily
Start Time: 09:30
...

Запуск задания вручную:

schtasks /Run /TN "Admin\Python Report"

Удаление задания:

schtasks /Delete /TN "Admin\Python Report" /F

Параметр /RU SYSTEM указывает учетную запись SYSTEM, которая не требует пароля, но имеет ограниченный доступ к сетевым ресурсам.

Запуск Python скрипта как службы через NSSM

NSSM позволяет превратить команду Python в службу Windows. Установка службы:

nssm install ReportWorker
nssm set ReportWorker Application C:\Python\312\python.exe
nssm set ReportWorker AppParameters C:\Scripts\worker.py --queue reports
nssm set ReportWorker AppDirectory C:\Scripts
nssm set ReportWorker AppStdout C:\Logs\worker.log
nssm set ReportWorker AppStderr C:\Logs\worker_err.log
nssm start ReportWorker

Проверка статуса:

nssm status ReportWorker

SERVICE_RUNNING

Если служба не нужна, она останавливается и удаляется:

nssm stop ReportWorker
nssm remove ReportWorker confirm

Для службы используется конфигурация реестра, создаваемая NSSM. Логи пишутся в файлы, указанные в AppStdout и AppStderr. Это решение подходит для длительных процессов, которые должны запускаться при старте Windows.

Использование pythonw.exe для графической программы

C:\Scripts\.venv\Scripts\pythonw.exe C:\Scripts\tray_app.pyw

Файл .pyw не открывает консольное окно. Для проверки работоспособности такой программы добавляется файл-журнал:

# tray_app.pyw
from pathlib import Path
import sys
log = Path.home() / "tray_app.log"
with open(log, "a", encoding="utf-8") as f:
    f.write("started with args: " + repr(sys.argv) + "\n")

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

Запуск с выбором интерпретатора через .bat

Пакетный файл может автоматически выбирать установленную версию Python. Для универсального окружения создается bat-файл:

@echo off
set PYTHONUTF8=1
where py >nul 2>nul
if %errorlevel%==0 (
    py -3.12 "C:\Scripts\main.py" %*
) else (
    python "C:\Scripts\main.py" %*
)

Передача аргументов через %* сохраняет все параметры, переданные в bat-файл. Такой файл удобен для старых систем, где py может отсутствовать.