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

Приставка «микро» обманывает новичков в обе стороны. Одни думают, что на 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 будет трудно отличить от ошибок самого языка.
Порядок ниже выстроен так, чтобы каждый шаг опирался на предыдущий и давал работающий результат: сначала связь «адрес — функция — ответ», затем страница, затем данные от пользователя и только потом база. Если начать с базы и расширений, новичок тонет в настройке и не понимает, какая часть что делает.
- Пройдите официальное руководство по быстрому старту: одна страница, затем маршрут с параметром вроде
/user/<name>. - Перенесите HTML в шаблоны Jinja: базовый шаблон с наследованием, цикл, условие, фильтр.
- Добавьте форму: чтение
request.form, перенаправление после отправки, сообщение об ошибке. - Подключите SQLite через
sqlite3, потом попробуйте SQLAlchemy и сравните объём кода. - Добавьте адрес, который отдаёт JSON, и вызовите его из Python-скрипта.
- Разбейте приложение на модули с помощью blueprints и напишите тесты через встроенный тестовый клиент.
Если нужна программа с проверкой кода, курс Хекслета «Python-разработчик» рассчитан на десять месяцев на стандартном тарифе и заканчивается блоком «Веб-разработка на Flask и Django». Проект «Анализатор страниц» делается на Flask и проходит код-ревью наставника. Подробного списка тем по Flask в программе нет, его стоит уточнить у школы.
Упражнения и частые ошибки
Учебный пример легко развивать: отмена записи, лимит мест, страница одной встречи, фильтр по дате в 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, в финале групповой проект. Срок по блоку цены — девять месяцев, но единую длительность и расписание стоит уточнить у школы до оплаты.
Взрослому полезно спросить у любой школы три вещи: будет ли проект на Flask для портфолио, проверяет ли наставник код, а не только автотесты, и разбирают ли выкладку на сервер без отладочного режима.
Сравнить онлайн-школы по более широкому направлению помогает рейтинг онлайн-курсов по Python: это общий рейтинг по языку, а не подборка именно по Flask, поэтому место Flask в каждой программе проверяйте по её плану. Признак готовности к платному обучению — учебное приложение из этой статьи уже работает с SQLite и проходит проверку на <b>тест</b>.