Python 编程实战 · 实用工具与库 — Flask 基础入门

1. Flask 基础概念

Flask 是什么？

• 一个 微框架（Micro Framework）
• 默认只提供核心组件：路由、请求处理、模板、调试器
• 需要什么功能就安装什么扩展（ORM、表单验证、JWT、数据库等）

Flask 的优势

• 代码简洁、上手快

• 灵活度极高（不像 Django 那样有强约束）

• 大量插件生态，如：

  • Flask-RESTful（构建 REST API）
  • Flask-SQLAlchemy（数据库 ORM）
  • Flask-Login（登录鉴权）
  • Flask-JWT-Extended（JWT）

2. Flask 环境搭建

pip install flask

验证安装：

import flask
print(flask.__version__)

3. 第一个 Flask 项目

创建 app.py

from flask import Flask

app = Flask(__name__)

@app.route('/')
def index():
    return "Hello Flask!"

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

运行：

python app.py

浏览器访问：

http://127.0.0.1:5000/

4. 路由（Routing）

路由就是 URL 与函数的映射。

① 基本路由

@app.route('/hello')
def hello():
    return "Hello!"

② 路由参数

@app.route('/user/<name>')
def get_user(name):
    return f"User: {name}"

类型转换器：

@app.route('/add/<int:a>/<int:b>')
def add(a, b):
    return str(a + b)

5. 请求与响应

Flask 提供 request 对象用于获取 HTTP 请求数据。

from flask import request

@app.route('/login', methods=['POST'])
def login():
    username = request.form.get('username')
    return f"Welcome {username}"

获取不同数据来源：

示例：JSON 接口

@app.route('/api/add', methods=['POST'])
def api_add():
    data = request.json
    return {
        "result": data["a"] + data["b"]
    }

6. 返回 JSON 数据

推荐使用 jsonify：

from flask import jsonify

@app.route('/info')
def info():
    return jsonify({"name": "Flask", "version": 2.0})

7. 模板渲染（Jinja2）

Flask 默认使用 Jinja2 模板引擎。

目录结构：

project/
  app.py
  templates/
    index.html

app.py：

from flask import render_template

@app.route('/page')
def page():
    return render_template('index.html', title="首页")

index.html:

<h1>{{ title }}</h1>

8. 静态文件（CSS/JS/图片）

默认路径：static/

project/
  static/
    style.css

HTML 使用：

<link rel="stylesheet" href="/static/style.css">

9. 项目结构推荐（小型项目）

project/
  app.py
  templates/
  static/
  requirements.txt

10. Flask 扩展（常用）

安装示例：

pip install flask_sqlalchemy
pip install flask_cors

11. 生产环境部署

开发环境用 Flask 自带的调试服务器即可，但生产环境应使用：

• Gunicorn + Nginx（Linux）
• Waitress（Windows）
• Docker（最佳方案）

示例（Gunicorn）：

gunicorn -w 4 app:app

12. 实战练习：构建简易 REST API

from flask import Flask, request, jsonify

app = Flask(__name__)

db = []

@app.route('/items', methods=['GET'])
def get_items():
    return jsonify(db)

@app.route('/items', methods=['POST'])
def add_item():
    item = request.json
    db.append(item)
    return jsonify({"msg": "added", "item": item})

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

测试 POST 接口：

POST /items
{
  "name": "apple",
  "qty": 5
}

总结

通过这篇内容，你已经掌握 Flask 的基础技能：

搭建 Flask 项目 路由配置 请求与响应 处理 JSON / 表单 模板引擎 静态文件 推荐项目结构 REST API 实战