Перейти к содержимому
Учи.Онлайн Выбрать школу
Статья

Flask: первый сайт и API на Python — кому хватит микрофреймворка и как его учить

Flask — микрофреймворк на Python для небольших сайтов и API. Вы пишете функцию, привязываете её к адресу вроде / или /api/meetings, а Flask вызывает эту функцию, когда браузер или другая программа обращается по этому адресу. Ответом может быть HTML-страница, собранная из шаблона Jinja, или данные в JSON. Базу данных, вход по паролю и проверку форм Flask не навязывает: их подключают отдельными библиотеками. Поэтому он хорошо подходит для первого сайта, внутреннего инструмента или маленького сервиса, а для проекта с админкой и десятками таблиц удобнее взять полный фреймворк.

Автор: редакция Учи.ОнлайнОтветственный редактор: Дмитрий Игнатьев
Содержание
Иллюстрация к статье: Flask: первый сайт и API на Python — кому хватит микрофреймворка и как его учить

Приставка «микро» обманывает новичков в обе стороны. Одни думают, что на Flask нельзя сделать ничего серьёзного, другие — что раз кода мало, то и думать не о чем. На деле первое приложение помещается в один файл, но решения, которые в Django уже приняты за вас, во Flask принимаете вы сами: где хранить данные, как называть шаблоны, когда включать отладку.

Что делает Flask и где кончается «микро»

Минимальное приложение из описания на PyPI — это импорт, создание объекта app и одна функция с декоратором @app.route("/"), которая возвращает строку «Hello, World!». Запуск — команда flask --app hello run. Актуальная версия на октябрь 2026 года — Flask 3.1.3 от 19 февраля 2026 года, она требует Python 3.9 или новее.

Из коробки Flask умеет четыре вещи: сопоставлять адреса с функциями, читать из запроса параметры и поля формы, отдавать ответ с нужным кодом и заголовками, собирать HTML по шаблонам Jinja. Всё остальное — расширения и обычные библиотеки: SQLAlchemy или встроенный в Python модуль sqlite3 для базы, Flask-Login для входа, WTForms для форм.

Когда Flask удобнее Django и FastAPI

О Django, FastAPI и fullstack-разработке на Python на сайте есть отдельные статьи, здесь только развилка. Django выигрывает, когда нужны готовая админка, учётные записи с правами и миграции базы без отдельного выбора библиотек. FastAPI выигрывает, когда главный продукт — API: он проверяет входные данные по аннотациям типов и сам строит документацию. Flask удобен посередине: несколько HTML-страниц и пара JSON-адресов, учебный проект, где важно видеть каждую деталь, прототип или небольшой внутренний сервис.

Простая проверка: перечислите, что приложение должно уметь через три месяца. Если там роли сотрудников, панель для десятка таблиц и журнал изменений, на Flask вы будете вручную собирать то, что в Django уже есть. Если расписание, форма записи и выдача данных боту, Flask справится без лишнего веса.

Учебный пример: запись на встречи клуба настольных игр

Ситуация учебная. Организатор клуба ведёт запись на встречи в общем чате, и списки теряются. Ему нужна страница, где видны ближайшие встречи и можно записаться, а также адрес, с которого чат-бот заберёт расписание. Всё приложение помещается в файл app.py:

from flask import Flask, render_template, request, redirect, url_for, jsonify

app = Flask(__name__)
meetings = [{"id": 1, "title": "Каркассон", "date": "2026-10-24", "players": []}]

@app.get("/")
def index():
    return render_template("index.html", meetings=meetings)

@app.post("/join/<int:meeting_id>")
def join(meeting_id):
    name = request.form.get("name", "").strip()
    if name:
        meetings[meeting_id - 1]["players"].append(name)
    return redirect(url_for("index"))

@app.get("/api/meetings")
def api_meetings():
    return jsonify(meetings)

Шаблон templates/index.html выводит список и форму:

{% for m in meetings %}
  <h2>{{ m.title }}, {{ m.date }}</h2>
  <p>Записались: {{ m.players | join(", ") }}</p>
  <form method="post" action="{{ url_for('join', meeting_id=m.id) }}">
    <input name="name"> <button>Записаться</button>
  </form>
{% endfor %}

Первая функция отдаёт страницу, вторая принимает форму и перенаправляет обратно, чтобы обновление страницы не отправило форму повторно, третья отдаёт тот же список в JSON для бота. Адреса собирает url_for: если маршрут переименуют, ссылки в шаблоне не сломаются. Слабое место — список в памяти пропадёт при перезапуске, так что перенос в SQLite станет первым упражнением.

Шаблоны Jinja: почему расширение файла влияет на безопасность

Имя участника попадает в HTML. Если кто-то впишет вместо имени <script>…</script>, браузер может выполнить этот код у каждого посетителя страницы. От этого защищает автоматическое экранирование: Jinja превращает угловые скобки в безопасные символы, и тег показывается как текст.

Тонкость в том, когда экранирование включено. В документации Flask о шаблонах сказано: при вызове render_template() оно работает для шаблонов с расширениями .html, .htm, .xml, .xhtml и .svg. Шаблон с другим окончанием — index.jinja, card.j2 или letter.txt — Flask отрисует без экранирования. Такие расширения встречаются в учебных материалах и настройках редакторов, и переименование файла «для подсветки» незаметно отключает защиту. При этом render_template_string() экранирует всегда. Явно отключают экранирование фильтр |safe, обёртка Markup и блок {% autoescape false %}.

Проверка занимает минуту: впишите в поле имени <b>тест</b>. Если на странице видны сами теги, экранирование работает. Если слово стало жирным, найдите шаблон с неподходящим расширением или лишний |safe.

Что знать до начала и в каком порядке осваивать

До Flask нужен уверенный базовый Python: функции, словари и списки, импорт модулей, виртуальное окружение. Пригодится и минимальный HTML: как устроены ссылка и форма, чем запрос GET отличается от POST. Без этого ошибки Flask будет трудно отличить от ошибок самого языка.

Порядок ниже выстроен так, чтобы каждый шаг опирался на предыдущий и давал работающий результат: сначала связь «адрес — функция — ответ», затем страница, затем данные от пользователя и только потом база. Если начать с базы и расширений, новичок тонет в настройке и не понимает, какая часть что делает.

  1. Пройдите официальное руководство по быстрому старту: одна страница, затем маршрут с параметром вроде /user/<name>.
  2. Перенесите HTML в шаблоны Jinja: базовый шаблон с наследованием, цикл, условие, фильтр.
  3. Добавьте форму: чтение request.form, перенаправление после отправки, сообщение об ошибке.
  4. Подключите SQLite через sqlite3, потом попробуйте SQLAlchemy и сравните объём кода.
  5. Добавьте адрес, который отдаёт JSON, и вызовите его из Python-скрипта.
  6. Разбейте приложение на модули с помощью blueprints и напишите тесты через встроенный тестовый клиент.

Если нужна программа с проверкой кода, курс Хекслета «Python-разработчик» рассчитан на десять месяцев на стандартном тарифе и заканчивается блоком «Веб-разработка на Flask и Django». Проект «Анализатор страниц» делается на Flask и проходит код-ревью наставника. Подробного списка тем по Flask в программе нет, его стоит уточнить у школы.

Открыть курс «Python-разработчик»

Упражнения и частые ошибки

Учебный пример легко развивать: отмена записи, лимит мест, страница одной встречи, фильтр по дате в JSON-адресе. Каждое упражнение проверяйте в браузере и запросом из скрипта: страница и API должны отдавать одни и те же данные.

Типичные ошибки описаны в руководстве по быстрому старту Flask. Файл приложения называют flask.py, и импорт ломается, потому что имя совпадает с самой библиотекой. Сайт выкладывают на сервер со встроенным сервером разработки и включённым флагом --debug. Документация предупреждает, что отладчик позволяет выполнять произвольный код Python из браузера, поэтому на рабочем сервере его не запускают. Третья ошибка — хранить в session что-то секретное: Flask подписывает cookie, но не шифрует её, и пользователь видит содержимое, хотя изменить его без секретного ключа не может.

Ещё одна история — глобальный список вместо базы, как в примере выше. В одном процессе всё работает, но стоит запустить несколько, и у каждого окажется свой список, а записи начнут «пропадать».

Как Flask влияет на доход

Отдельной профессии «Flask-разработчик» почти нет: Flask встречается в вакансиях бэкенд-разработчиков на Python рядом с SQL, Docker и другими фреймворками, а у аналитиков и инженеров данных — как способ отдать расчёт через веб-страницу или API. Сам по себе навык редко поднимает зарплату, зато расширяет круг задач: внутренний инструмент для коллег без очереди к разработчикам, тестовое задание с небольшим сервисом.

Открытые данные по Flask скудные. Калькулятор Хабр Карьеры для специализации «Бэкенд-разработчик» с навыком Flask при проверке в октябре 2026 года показывал 228 000 рублей в месяц, рассчитанные по 17 анкетам, без фильтра по региону и по всем уровням квалификации. Период и тип показателя на открытой части страницы не видны, разбивка по уровням скрыта, выборка мала: это ориентир, а не обещание зарплаты новичку. Для своей ситуации выберите в калькуляторе уровень и город, а на сайтах вакансий отфильтруйте предложения по слову Flask и опыту; сравнивайте медиану, а не среднее.

Как выбрать обучение

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

Для подростков с базой Python есть курс CODDY «Веб-приложения на Python» при партнёрстве с ВМК МГУ для 13–16 лет. Он рассчитан на семь месяцев и не меньше 56 часов в группе. После продвинутого ООП идёт модуль по Flask с веб-формами, шаблонами и базами данных, а итог — собственное веб-приложение, которое ученик защищает перед комиссией с участием преподавателей факультета. Новичкам курс не подходит: нужны уверенные циклы, функции, списки и словари.

Открыть курс

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

Так устроен курс Skillbox «Программирование на Python для детей» для 11–14 лет без опыта. В первом модуле основы Python, во втором 2D-игра на PyGame, в третьем блоке HTML, CSS, Flask и Jinja вместе с Telegram-ботом на SQLite, в финале групповой проект. Срок по блоку цены — девять месяцев, но единую длительность и расписание стоит уточнить у школы до оплаты.

Открыть курс «Программирование на Python для детей»

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

Сравнить онлайн-школы по более широкому направлению помогает рейтинг онлайн-курсов по Python: это общий рейтинг по языку, а не подборка именно по Flask, поэтому место Flask в каждой программе проверяйте по её плану. Признак готовности к платному обучению — учебное приложение из этой статьи уже работает с SQLite и проходит проверку на <b>тест</b>.