Установка Flask

Прежде чем начать писать приложения на Flask, нам нужно подготовить среду Python и установить Flask.

Установка Flask довольно проста.

Flask — это библиотека Python, поэтому сначала убедитесь, что Python установлен на вашем компьютере.

Требования к версии Python

Требования Flask 3.xPython 3.9 и выше。

Если вы ещё не установили Python, его можно скачать сpython.orgСкачайте и установите.

После установки откройте терминал, чтобы проверить:

$ python3 --version
Python 3.12.3

$ pip3 --version
pip 24.0 from /usr/lib/python3.12/site-packages/pip (python 3.12)

В macOS и большинстве дистрибутивов Linux Python 3 уже предустановлен. Если вы используете Windows, при установке отметьте пунктAdd Python to PATH.

Виртуальное окружение

Виртуальное окружение — это стандартная практика для проектов на Python. Оно создаёт независимое пространство пакетов Python для каждого проекта.

Зачем использовать виртуальное окружение

Предположим, у вас есть два проекта: проекту A нужен Flask 3.0, а проекту B — Flask 2.3.

Если установить их глобально, две версии Flask будут конфликтовать друг с другом.

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

Встроенный в Pythonvenvмодуль может создавать виртуальные окружения без установки дополнительных инструментов.

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

Сначала создайте каталог проекта, затем создайте в нём виртуальное окружение:

$ mkdir example-flask-test
$ cd example-flask-test
$ python3 -m venv .venv

.venv— это имя каталога виртуального окружения. Вы можете изменить его на любое понравившееся имя, но.venv— наиболее распространённое соглашение в сообществе.

Активируйте виртуальное окружение

Операционная система	Команда активации
macOS / Linux	. .venv/bin/activateилиsource .venv/bin/activate
Windows (CMD)	.venv\Scripts\activate
Windows (PowerShell)	.venv\Scripts\Activate.ps1

После успешной активации приглашение терминала будет предварено индикатором(.venv), указывающим, что виртуальная среда активна

$ . .venv/bin/activate
(.venv) $   # <-- 提示符变了，说明虚拟环境已经激活

Выход из виртуальной среды

После завершения разработки используйтеdeactivateкоманду для выхода:

(.venv) $ deactivate
$

Каждый раз при открытии нового окна терминала необходимо повторно активировать виртуальную среду перед использованием Flask.

Вы также можете использовать uv, инструмент управления пакетами и средами Python. См.:https://www.example.com/python3/uv-tutorial.html
# 使用指定 Python 版本创建虚拟环境
uv venv --python 3.12
激活虚拟环境：

# macOS / Linux
source .venv/bin/activate

# Windows（PowerShell）
.venv\Scripts\activate

Установка Flask

С активированной виртуальной средой используйте pip для установки Flask:

(.venv) $ pip install Flask

После установки проверьте, успешно ли установлен Flask:

flask --version

Вывод будет похож на следующий:

Python 3.9.6
Flask 3.0.0
Werkzeug 3.1.5

Вы также можете проверить с помощью следующего кода:

from importlib.metadata import version

flask_version = version("flask")
print(flask_version)

Если установка прошла успешно, будет выведен номер версии, похожий на следующий:

3.1.3

На этом этапе вместе с ним также устанавливаются следующие пакеты зависимостей:Werkzeug、Jinja2、Click、itsdangerous、blinker。

Необязательно: установите python-dotenv

python-dotenvПозволяет вам с помощью файлов.envи.flaskenvуправлять переменными среды, упрощая использование команд Flask:

(.venv) $ pip install python-dotenv

Хотя это и не обязательно, в реальной разработке это настоятельно рекомендуется. Это избавляет вас от необходимости каждый раз вводить--appпараметры, а также упрощает командам обмен конфигурацией окружения.

Структура каталогов проекта

Прежде чем начать писать код, полезно понять стандартную структуру каталогов проекта Flask:

myflaskapp/
├── .venv/          # 虚拟环境（不要提交到 Git）
├── app.py           # 应用入口文件
├── templates/       # Jinja2 模板文件目录
├── static/          # CSS、JS、图片等静态文件目录
├── .flaskenv        # Flask 环境变量（可选）
└── .gitignore       # 忽略 .venv 等不需要提交的文件