Python Step Visualizer (Local)

Учитесь понимать Python: наблюдайте, какая строка исполняется и как меняются переменные.

Расширение от voipp подсвечивает строки прямо в редакторе VS Code и открывает рядом панель управления. Исполнение локальное: исходники не отправляются на сервер, интернет при работе не нужен.

Возможности

• Автоматическое пошаговое исполнение с интервалом от 0,1 до 3 секунд.
• Запуск, пауза, отдельный шаг и сброс.
• Жёлтая подсветка текущей строки, зелёная — ранее пройденных, красная — исключения.
• Локальные и глобальные переменные, выделение изменившихся значений.
• Стек вызовов и рекурсия внутри открытого файла.
• Вывод print() и подготовленные ответы для input().
• Ограничение времени, числа событий и объёма вывода.

Требования

• Windows 10/11 и локальная настольная версия VS Code 1.85+.
• CPython 3.10+, установленный отдельно.
• Сохранённый локальный файл .py в доверенной папке.

Расширения Microsoft Python и Python Debugger не обязательны. Установка библиотек через pip или npm для работы визуализатора не требуется. Проверено с Python 3.12.14 на Windows; остальные поддерживаемые версии отдельно не проверялись.

Быстрый старт

1. Откройте .py в VS Code.
2. Нажмите Ctrl+Shift+P и выберите Python Step Visualizer: Открыть визуализатор. Команда также доступна через значок в заголовке редактора Python.
3. В панели справа отметьте, что доверяете коду, и нажмите Запуск.
4. Меняйте интервал ползунком. Нажмите Пауза, чтобы остановиться на ближайшем событии, или Шаг, чтобы продолжить вручную.
5. Сброс завершает процесс и очищает результат. Следующий запуск начнётся заново.

Попробуйте этот пример:

numbers = [3, 7, 2, 9]
total = 0
for number in numbers:
    total += number
    print(number, total)
average = total / len(numbers)
print("Среднее:", average)

Итог: total = 21, average = 5.25.

Как читать подсветку

Жёлтая строка — точка исполнения. Пока программа ожидает шаг, эта строка ещё не выполнена: значения переменных соответствуют состоянию до неё. После команды шага маркер остаётся на строке до следующего события.

Зелёная строка уже была запущена. Она могла вызвать функцию или исключение, поэтому цвет не гарантирует успешного завершения всех операций на ней.

Красная строка обозначает исключение. Оно может быть обработано через try/except; продолжите исполнение, чтобы увидеть результат.

Возврат из функции, yield и исключение также являются отдельными событиями. Это переход внутрь функций, а не аналог Step Over/F10. Интервал задаётся между событиями, а длительность самой операции добавляется к нему.

Выбор Python

По умолчанию расширение ищет py -3, затем python. Интерпретатор из команды Microsoft Python Select Interpreter автоматически не используется.

1. Откройте настройки Ctrl+,.
2. Найдите pythonStepVisualizer.pythonPath.
3. Вставьте полный путь к нужному python.exe, без кавычек и аргументов.
4. Нажмите «Сброс» и запустите снова.

Для поиска установленного интерпретатора выполните в терминале:

py -3 -c "import sys; print(sys.executable)"

Ввод и редактирование

Ответы для input() указываются в панели до запуска, по одному на строку. Если их не хватит, программа получит EOFError. Добавление ответов во время исполнения не поддерживается.

Исполняется текущий текст редактора, включая несохранённые изменения уже созданного файла. Правка кода сбрасывает сессию, чтобы подсветка не смещалась. Одновременно поддерживается один файл.

Безопасность

Это не песочница. Python-код получает ваши права доступа к файлам, сети и программам. Запускайте только код, которому доверяете. Для неизвестного кода используйте отдельную изолированную виртуальную машину. Не запускайте VS Code от администратора.

Для обычных учебных ошибок предусмотрены отдельный процесс Python, общий таймер 300 секунд (можно выбрать 30–1800 секунд, включая паузы), лимит 10 000 событий и 24 000 символов вывода. На Windows Job Object завершает обычные дочерние процессы вместе с процессом исполнения. При невозможности создать Job пользовательский код не запускается.

Просмотр переменных не вызывает пользовательские __repr__, __str__ и свойства. Объекты неизвестных типов показаны кратко; большие значения и контейнеры сокращаются. Панель отображает данные как текст, не загружает внешние ресурсы и не отправляет телеметрию.

Эти меры не защищают от вредоносного кода. Лимита памяти и запрета файловых/сетевых операций нет. Сброс не отменяет уже сделанные изменения и не гарантирует выполнение finally или atexit.

Ограничения

• Трассируется только открытый файл и главный поток. Импорты выполняются, но строки других файлов не подсвечиваются.
• Пауза действует на следующем событии трассировки. Для отмены долгого библиотечного вызова используйте «Сброс».
• Потоки, multiprocessing, async-задачи и GUI-программы не поддерживаются как согласованная пошаговая модель. Для них нужен обычный отладчик.
• Пустые строки и комментарии пропускаются; циклы и многострочные выражения следуют событиям CPython. Несколько выражений на одной строке не разделяются на шаги.
• Подмена потоков, sys.settrace, одновременный отладчик, os.write(1, ...), sys.__stdout__, getpass() и программы, требующие настоящего терминала, могут нарушить работу.
• Используется запуск файла с -I и UTF-8. Настройки PYTHONPATH, пользовательские site-packages, аргументы командной строки, python -m и launch.json не применяются. Рабочая папка — папка файла.
• Jupyter, WSL, SSH, Dev Containers, виртуальные рабочие пространства и браузерный VS Code не поддерживаются.

Лицензия

MIT. Исходники JavaScript и Python входят в пакет расширения.