Что такое Flask и для чего он подходит
Flask - микрофреймворк для веб-приложений на Python. Он даёт только основу: приём запросов, маршрутизацию, шаблоны Jinja2 и работу с формами. Базу данных, авторизацию и админку подключают отдельными расширениями, поэтому структуру проекта вы выбираете сами.
Такой подход удобен для небольших сайтов, прототипов, внутренних сервисов и API. Если нужен готовый набор с ORM и админ-панелью, посмотрите Django. Перед началом полезно знать основы Python: функции, словари, импорты.
Ниже по шагам собирается небольшое приложение: установка, первый маршрут, параметры в адресе, шаблон, форма и запуск в режиме отладки. Команды соответствуют актуальной ветке Flask 3.x.
Установка Flask в виртуальное окружение
Flask, как и другие библиотеки, ставят в отдельное виртуальное окружение: так версии пакетов проекта не конфликтуют с остальными. Подробности смотрите в статье про venv, а если Python ещё не установлен, начните с инструкции для Windows.
Команды для Windows создают папку, окружение, активируют его и ставят Flask через pip:
mkdir flask-demo
cd flask-demo
py -m venv .venv
.venv\Scripts\activate
python -m pip install FlaskНа Linux и macOS активация выглядит как source .venv/bin/activate. В начале строки терминала появится пометка (.venv): значит, окружение включено. Назвать свой файл flask.py нельзя, он перекроет сам пакет, используйте app.py.
Минимальное приложение и запуск
Создайте файл app.py. Три строки достаточно для работающего сайта:
from flask import Flask
app = Flask(__name__)
@app.route("/")
def index():
return "Привет, Flask!"Объект Flask(__name__) - само приложение, а декоратор @app.route связывает адрес с функцией. То, что функция вернёт, браузер получит в ответ. Запустите сервер разработки командой:
flask --app app run --debugПараметр --app app указывает модуль с приложением, а --debug включает режим отладки. В терминале появится адрес http://127.0.0.1:5000, откройте его в браузере и увидите приветствие.

Режим отладки включает автоперезагрузку при изменении кода и интерактивный отладчик с трассировкой ошибки прямо на странице. Именно поэтому его нельзя включать на публичном сервере: отладчик позволяет выполнять код. Для рабочей среды используют сервер вроде gunicorn или waitress, а не встроенный.
Маршруты и параметры в адресе
Адрес можно сделать динамическим: часть пути в угловых скобках передаётся в функцию как аргумент. Можно указать тип: int, float, path, uuid.
@app.route("/hello/<name>")
def hello(name):
return f"Привет, {name}!"
@app.route("/post/<int:post_id>")
def post(post_id):
return f"Запись номер {post_id}"Запрос на /hello/Аня вернёт приветствие с именем, а на /post/7 - строку с числом 7. Если вместо числа в адресе окажется текст, Flask сам ответит ошибкой 404. По умолчанию маршрут принимает только GET; другие методы указываются явно, о том, чем они различаются, написано в статье про HTTP-методы.
| Задача | Как записать |
|---|---|
| Адрес со строкой | @app.route("/user/<name>") |
| Адрес с числом | @app.route("/post/<int:post_id>") |
| Несколько методов | @app.route("/form", methods=["GET", "POST"]) |
| Ответ в формате JSON | return jsonify({"ok": True}) |
| Ошибка 404 | abort(404) |
| Построить адрес по имени функции | url_for("index") |
Для ответа в виде данных вызывайте jsonify: он сам задаст заголовок Content-Type и сериализует словарь. Подробнее о формате смотрите в статье про JSON.
Шаблоны Jinja2
Собирать HTML строками неудобно, для этого есть шаблоны. Flask ищет их в папке templates рядом с app.py. Сначала общий каркас base.html, от которого будут наследоваться остальные страницы:
<!doctype html>
<html lang="ru">
<head>
<meta charset="utf-8">
<title>{% block title %}Мой сайт{% endblock %}</title>
</head>
<body>
<nav><a href="{{ url_for('index') }}">Главная</a></nav>
{% block content %}{% endblock %}
</body>
</html>Блоки block - места, которые дочерние шаблоны заполняют своим содержимым. Страница index.html расширяет каркас и выводит список из переданных данных:
{% extends "base.html" %}
{% block title %}Главная{% endblock %}
{% block content %}
<h1>Привет, {{ user }}!</h1>
<ul>
{% for item in items %}
<li>{{ item }}</li>
{% else %}
<li>Список пуст</li>
{% endfor %}
</ul>
{% endblock %}Двойные фигурные скобки выводят значение (Jinja2 автоматически экранирует HTML), а конструкции с процентами задают логику. Осталось передать данные из функции через render_template:
from flask import render_template
@app.route("/")
def index():
return render_template("index.html", user="Аня", items=["Python", "Flask", "Jinja2"])Теперь главная страница показывает заголовок и маркированный список из трёх пунктов. Функцию url_for используют вместо жёстко записанных адресов: при смене маршрута ссылки не сломаются.
Формы и объект request
Данные формы и параметры запроса доступны через объект request. Для формы обратной связи маршрут должен принимать GET (показать форму) и POST (получить данные):
from flask import Flask, redirect, render_template, request, url_for
app = Flask(__name__)
messages = []
@app.route("/feedback", methods=["GET", "POST"])
def feedback():
if request.method == "POST":
name = request.form.get("name", "").strip()
text = request.form.get("text", "").strip()
if name and text:
messages.append({"name": name, "text": text})
return redirect(url_for("feedback"))
return render_template("feedback.html", messages=messages)Метод request.form.get безопаснее обращения по ключу: если поля нет, вернётся значение по умолчанию вместо ошибки 400. После успешной отправки делается перенаправление на тот же адрес, чтобы повторное обновление страницы не отправляло форму заново. Сообщения хранятся в списке в памяти, после перезапуска сервера они пропадут; для постоянного хранения подключают базу данных, например через Flask-SQLAlchemy.
Шаблон feedback.html с формой и выводом сообщений:
{% extends "base.html" %}
{% block content %}
<h1>Обратная связь</h1>
<form method="post">
<input name="name" placeholder="Имя" required>
<textarea name="text" placeholder="Сообщение" required></textarea>
<button type="submit">Отправить</button>
</form>
{% for m in messages %}
<p><strong>{{ m.name }}:</strong> {{ m.text }}</p>
{% endfor %}
{% endblock %}Параметры из адреса вида ?q=python читаются через request.args.get("q"), а JSON из тела запроса - через request.get_json(). Приложение с готовым примером можно сравнить с другим разбором веб-приложения на Flask.

Для форм, которые меняют данные, добавьте защиту от CSRF, например через расширение Flask-WTF. А секретные значения, вроде SECRET_KEY, держите в переменных окружения, а не в коде репозитория.
Структура проекта и что изучать дальше
Когда приложение вырастет, один файл перестанет быть удобным. Типичная структура: папка templates для шаблонов, папка static для CSS, картинок и скриптов, файл requirements.txt со списком зависимостей. Крупные приложения делят на части через blueprints и создают приложение функцией-фабрикой.
Ошибки, на которые часто жалуются новички: ModuleNotFoundError, если Flask установлен не в то окружение; TemplateNotFound, если папка называется не templates или лежит не рядом с app.py; повторный запуск сервера на занятом порту 5000. В последнем случае запустите сервер с другим портом: flask --app app run --debug --port 5001.
Дальше изучайте расширения Flask-SQLAlchemy для базы данных, Flask-Login для входа пользователей и Flask-Migrate для миграций. Для разработки в редакторе пригодится материал про настройку VS Code.
