当前位置：首页 > news >正文

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

news 2025/11/15 6:25:48

Flask 是 Python 生态中最灵活、最轻量的 Web 框架之一，非常适合快速构建接口、网站原型、后台服务等。它遵循 WSGI 标准，核心库极其简洁，但可以通过插件无限扩展。

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 Flaskapp = 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}"

✔ 获取不同数据来源：

来源	写法
URL 参数	`request.args`
表单数据	`request.form`
JSON 数据	`request.json`
文件上传	`request.files`

示例：JSON 接口

@app.route('/api/add', methods=['POST'])
def api_add():data = request.jsonreturn {"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.pytemplates/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.pytemplates/static/requirements.txt

10. Flask 扩展（常用）

功能	扩展
ORM	Flask-SQLAlchemy
登录鉴权	Flask-Login
表单验证	WTForms / Flask-WTF
REST API	Flask-RESTful
跨域	Flask-Cors
JWT	Flask-JWT-Extended

安装示例：

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, jsonifyapp = Flask(__name__)db = []@app.route('/items', methods=['GET'])
def get_items():return jsonify(db)@app.route('/items', methods=['POST'])
def add_item():item = request.jsondb.append(item)return jsonify({"msg": "added", "item": item})if __name__ == "__main__":app.run(debug=True)