跳到主要内容

环境安装

本章节介绍如何安装 Flask 并设置开发环境。

系统要求​

  • Python 3.8 或更高版本
  • pip 包管理器
  • 虚拟环境工具（推荐）

创建虚拟环境​

使用 venv（推荐）​

# 创建项目目录
mkdir myflaskapp
cd myflaskapp

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows:
venv\Scripts\activate

# macOS/Linux:
source venv/bin/activate

使用 conda​

# 创建环境
conda create -n flaskenv python=3.11

# 激活环境
conda activate flaskenv

安装 Flask​

基础安装​

pip install flask

安装常用扩展​

pip install flask flask-sqlalchemy flask-wtf flask-login flask-migrate

使用 requirements.txt​

创建 requirements.txt：

Flask==3.0.0
Flask-SQLAlchemy==3.1.1
Flask-WTF==1.2.1
Flask-Login==0.6.3
Flask-Migrate==4.0.5
python-dotenv==1.0.0

安装依赖：

pip install -r requirements.txt

验证安装​

import flask
print(flask.__version__)

第一个 Flask 应用​

创建 app.py：

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return '<h1>Hello, Flask!</h1>'

@app.route('/user/<name>')
def user(name):
    return f'<h1>Hello, {name}!</h1>'

if __name__ == '__main__':
    app.run(debug=True)

运行应用：

python app.py

访问 http://127.0.0.1:5000/ 查看结果。

项目结构​

推荐的项目结构：

myflaskapp/
├── app/
│   ├── __init__.py
│   ├── routes.py
│   ├── models.py
│   ├── forms.py
│   ├── templates/
│   │   └── base.html
│   └── static/
│       ├── css/
│       ├── js/
│       └── images/
├── migrations/
├── tests/
├── config.py
├── requirements.txt
└── run.py

环境变量配置​

创建 .env 文件：

FLASK_APP=run.py
FLASK_ENV=development
SECRET_KEY=your-secret-key-here
DATABASE_URL=sqlite:///app.db

安装 python-dotenv：

pip install python-dotenv

在应用中加载：

from dotenv import load_dotenv
import os

load_dotenv()

app = Flask(__name__)
app.config['SECRET_KEY'] = os.getenv('SECRET_KEY')

开发工具推荐​

  • IDE: PyCharm, VS Code
  • 调试: Flask 内置调试器, pdb
  • 测试: pytest, coverage
  • 代码质量: flake8, black, mypy

下一步​

学习 Flask 的路由系统，了解如何处理不同的 URL 和 HTTP 方法。