安装 Flask 非常简单,但为了保证项目的整洁和依赖的隔离,强烈建议在虚拟环境中进行安装。
以下是完整的安装指南:
1. 前置条件:检查 Python 版本
Flask 需要 Python 3.8 或更高版本(推荐使用 3.10 及以上)。
打开终端(Terminal)或命令提示符(CMD),输入以下命令检查版本:
python --version
# 或者在 macOS/Linux 上:
python3 --version如果未安装 Python 或版本过低,请先前往 Python 官网 下载安装。
2. 创建项目目录并进入
首先,为你的项目创建一个文件夹,并进入该目录:
# 创建项目文件夹
mkdir my_flask_project
# 进入文件夹
cd my_flask_project3. 创建和激活虚拟环境(⭐ 关键步骤)
虚拟环境可以为每个项目创建独立的 Python 运行环境,避免不同项目之间的包版本冲突。
创建虚拟环境
# Windows / macOS / Linux 通用命令
python -m venv venv
# 如果系统提示找不到 python,请尝试使用 python3:
# python3 -m venv venv(这会在当前目录下生成一个名为 venv 的文件夹,里面包含了独立的 Python 解释器和 pip。)
激活虚拟环境
激活后,你的命令行提示符前面会出现 (venv) 字样。
Windows (命令提示符 CMD):
venv\Scripts\activateWindows (PowerShell):
venv\Scripts\Activate.ps1(注:如果 PowerShell 提示“无法加载文件…因为在此系统上禁止运行脚本”,请以管理员身份运行 PowerShell,然后执行 Set-ExecutionPolicy RemoteSigned,再重新激活。)
macOS / Linux:
source venv/bin/activate4. 安装 Flask
在激活了虚拟环境的状态下,使用 pip 安装 Flask:
pip install Flask(在 macOS/Linux 上,如果提示权限问题,请确保你已经正确激活了虚拟环境,通常不需要使用 sudo。)
5. 验证安装
安装完成后,验证 Flask 是否成功安装:
python -c "import flask; print(flask.__version__)"如果输出了 Flask 的版本号(例如 3.0.0),则说明安装成功!
💡 补充:安装常用 Flask 扩展
在实际开发中,你通常还需要安装一些官方或第三方的扩展。你可以在激活虚拟环境后,一次性安装它们:
# 数据库 ORM
pip install Flask-SQLAlchemy
# 数据库迁移工具
pip install Flask-Migrate
# 表单处理与验证
pip install Flask-WTF
# 用户登录会话管理
pip install Flask-Login
# 跨域支持 (常用于前后端分离的 API)
pip install Flask-CORS⚠️ 退出虚拟环境
当你完成开发,想要退出虚拟环境时,只需输入:
deactivate下一步:
安装完成后,你可以回到 Flask 教程的第一节:第一个 Flask 应用,开始编写你的第一行 Flask 代码了!