Установка Flask и первое приложение

Привет! Ты решил изучить Flask — один из самых популярных микрофреймворков для веб-разработки на Python. Flask лёгкий, гибкий и идеально подходит для небольших и средних проектов: API, блоги, прототипы, микросервисы. Он не навязывает структуру, позволяя использовать те инструменты, которые тебе нужны.

В этой статье мы разберём:

• Создание и активацию виртуального окружения
• Установку Flask
• Написание первого приложения
• Запуск development-сервера

Что нужно знать перед началом

Для этого урока тебе понадобится:

• Установленный Python (версия 3.8 или новее) 
• Базовое понимание командной строки

Совет: Flask — минималистичный фреймворк. Код первого приложения занимает всего несколько строк.

Основная часть

Создание виртуального окружения

Виртуальное окружение изолирует зависимости проекта, предотвращая конфликты между библиотеками.

Шаг 1. Создай папку для проекта и перейди в неё:

mkdir myflaskapp
cd myflaskapp

Шаг 2. Создай виртуальное окружение:

python -m venv venv

Совет: Название venv — стандартное и общепринятое. Его нужно добавить в .gitignore.

Шаг 3. Активируй виртуальное окружение:

Windows:

venv\Scripts\activate

macOS / Linux:

source venv/bin/activate

После активации в начале командной строки появится (venv) .

Важно: Всегда активируй виртуальное окружение перед установкой пакетов. Иначе они установятся в глобальную систему.

Установка Flask

В активированном виртуальном окружении установи Flask:

pip install flask

Проверь установку:

python -m flask --version

Совет: Сохрани зависимости в requirements.txt:

pip freeze > requirements.txt

Первое приложение (Hello, World!)

Создай файл app.py в папке проекта и напиши код:

from flask import Flask

# Создаём экземпляр приложения
app = Flask(__name__)

# Определяем маршрут для корневой страницы
@app.route('/')
def hello():
    return '<h1>Hello, Flask!</h1>'

# Запускаем сервер
if __name__ == '__main__':
    app.run(debug=True)

Разбор кода:

Совет: debug=True включает автоматическую перезагрузку при изменении кода и отображает подробные ошибки в браузере.

Запуск приложения

Запусти приложение:

python app.py

Ожидаемый вывод:

* Serving Flask app 'app'
* Debug mode: on
* Running on http://127.0.0.1:5000 (Press CTRL+C to quit)
* Restarting with stat
* Debugger is active!
* Debugger PIN: 123-456-789

Открой браузер и перейди по адресу: http://127.0.0.1:5000/.

Ты увидишь заголовок «Hello, Flask!».

Важно: Development-сервер предназначен только для разработки. Не используй его в продакшене .

Альтернативный способ запуска

Можно использовать команду flask вместо python app.py :

Шаг 1. Укажи переменную окружения:

Windows:

set FLASK_APP=app.py

macOS / Linux:

export FLASK_APP=app.py

Шаг 2. Запусти сервер:

flask run

Задачи для закрепления

Задача 1. Создай виртуальное окружение для нового проекта.

Задача 2. Установи Flask и проверь версию.

Задача 3. Напиши приложение «Hello, World!» и запусти его.

Задача 4. Что делает debug=True в app.run()?

Задача 5. Какой порт использует Flask по умолчанию?

Ответы:

Задача 1.

python -m venv venv
# Windows: venv\Scripts\activate
# macOS/Linux: source venv/bin/activate

Задача 2.

pip install flask
python -m flask --version

Задача 3.

from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello():
    return "Hello, World!"
if __name__ == '__main__':
    app.run(debug=True)

Задача 4.

# debug=True включает автоматическую перезагрузку при изменении кода
# и отображение подробных ошибок в браузере.

Задача 5.

# Flask по умолчанию использует порт 5000.

Нюансы и подводные камни

Не называй файл flask.py

Если назвать файл flask.py, он будет конфликтовать с самой библиотекой Flask .

Порт 5000 занят

Если порт 5000 занят, запусти сервер на другом порту:

python app.py --port=5001

Забыл активировать виртуальное окружение

Перед установкой пакетов проверь, что в командной строке видно (venv).

Шпаргалка

Заключение

Сегодня мы:

• Создали и активировали виртуальное окружение
• Установили Flask
• Написали первое приложение
• Запустили development-сервер

КВИЗ

Что дальше?

• Следующая статья: «Маршрутизация в Flask: @app.route()»