Ruff для Python: как за минуту отформатировать код и найти ошибки

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

Python-файл может запускаться и при этом содержать неиспользуемые импорты, неоднозначные имена и стиль, который мешает ревью. Поэтому отделим настройку, входные данные, основное действие и проверку. В этой статье вы соберёте мини-проект с настройкой в pyproject.toml, намеренной ошибкой и командами автоматического исправления. Проверка: первая проверка находит проблемы, команда --fix исправляет безопасные случаи, а повторный запуск завершается без замечаний.

Как устроен учебный проект Ruff

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

Контрольные точки: конфигурация, проверка, исправление и форматирование. Следующий шаг начинается после совпадения с ожидаемым результатом.

От входных данных до видимого результата. Сначала проверяется вход, затем действие и только потом интерфейс.

Собираем рабочий пример шаг за шагом

Пример сверялся с актуальной документацией официальной документации Ruff на 19 октября 2026 года. Установите инструмент командой uv tool install ruff либо запускайте без установки через uvx ruff. Проверьте текущую папку через pwd или Get-Location. Вставьте пример целиком, выполните один раз, затем разбирайте по частям.

mkdir ruff-demo && cd ruff-demo
cat > pyproject.toml <<'TOML'
[tool.ruff]
line-length = 88

[tool.ruff.lint]
select = ["E", "F", "I", "B"]
TOML

cat > app.py <<'PY'
import os


def total(prices: list[int]) -> int:
    return sum(prices)


print(total([120, 80, 300]))
PY

uvx ruff check app.py
uvx ruff check app.py --fix
uvx ruff format app.py
uvx ruff check app.py

Команда check отвечает за правила качества, а format приводит расположение пробелов и переносов к одному стилю. Найдите в примере вход, проверку и место формирования результата.

Что отличает устойчивый проект от случайного запуска. Явные границы делают ошибку локальной и понятной.

Что происходит внутри и почему это работает

Каждое сообщение Ruff содержит код правила, например F401. По коду легко открыть объяснение, понять риск и решить, нужна ли автоматическая правка. Логику держите отдельно от вывода: функция получает аргумент и возвращает значение, а интерфейс показывает его. Флаг --fix не означает «переписать программу». Ruff применяет только исправления, которые конкретное правило помечает как доступные; остальные замечания остаются в отчёте.

Начните с небольшого набора E, F, I и B. Не включайте сотни правил вслепую: старый проект может получить тысячи замечаний, которые ничего не учат. Для существующего кода сначала зафиксируйте текущий уровень, затем добавляйте категории по одной. Не прячьте поток в одном обработчике: сохраните вход, проверьте его, вызовите операцию и только затем обновите интерфейс.

Проверяем проект и добавляем свою функцию

Подключите Ruff к своему маленькому Python-проекту и сравните код до и после форматирования через git diff. До правки запишите ожидаемое поведение одним предложением. После граничного теста повторите обычный сценарий.

Ruff полезен не количеством правил, а короткой обратной связью: ошибка появляется рядом со строкой до того, как попадёт в ревью. Полезная правка проходит от нового ввода до видимого результата.

Четыре проверки перед следующим шагом. Каждый следующий этап начинается после наблюдаемого результата.

Что запомнить и куда двигаться дальше

Оставьте в README три команды: проверка, исправление и форматирование. Позже ту же проверку можно перенести в GitHub Actions, не меняя конфигурацию. Для закрепления откройте в статье про uv и окружение Python, в первых тестах pytest и в настройке Ruff через GitHub Actions.

Как изучить тему в Кодике

Сначала отделите синтаксис Python от инструментов качества: напишите чистую функцию, проверьте её результат, а затем добавьте линтер. Сначала восстановите главную функцию и проверьте её на трёх значениях.

После этого попробуйте объяснить, почему форматтер не заменяет тесты, а линтер не доказывает правильность бизнес-логики. Базовый синтаксис закрепите через курс Python.

Что получится в итоге

Так выглядит законченный учебный проект: есть понятный вход, видимый результат, защита от неверных данных и место для следующего улучшения.