Python 生态系统中有三个主流的 Web 开发框架:Django、Flask 和 FastAPI。它们在设计哲学、功能特性和适用场景上各有不同。
特性 | Django | Flask | FastAPI |
---|---|---|---|
类型 | 全功能框架 | 微框架 | 现代异步框架 |
学习曲线 | 较陡峭 | 平缓 | 中等 |
内置功能 | ORM, Admin, Auth, 模板 | 仅基础路由和模板 | 自动文档, 数据验证 |
性能 | 中等 | 中等 | 高性能(基于Starlette) |
异步支持 | 3.0+ 支持 | 不支持 | 原生支持 |
适用场景 | 内容管理系统, 企业应用 | 小型应用, 微服务 | API 服务, 实时应用 |
数据验证 | 表单系统 | 需扩展 | 内置(Pydantic) |
自动文档 | 需第三方 | 需第三方 | 内置(OpenAPI/Swagger) |
安装:
pip install django
基础项目结构:
myproject/
manage.py
myproject/
__init__.py
settings.py
urls.py
wsgi.py
myapp/
models.py
views.py
urls.py
示例代码:
# myapp/views.py
from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
from .models import Book
@csrf_exempt
def book_list(request):
if request.method == 'GET':
books = Book.objects.all()
data = [{'title': book.title, 'author': book.author} for book in books]
return JsonResponse(data, safe=False)
elif request.method == 'POST':
title = request.POST.get('title')
author = request.POST.get('author')
book = Book.objects.create(title=title, author=author)
return JsonResponse({'id': book.id}, status=201)
# myapp/urls.py
from django.urls import path
from . import views
urlpatterns = [
path('books/', views.book_list),
]
# myproject/urls.py
from django.contrib import admin
from django.urls import include, path
urlpatterns = [
path('admin/', admin.site.urls),
path('api/', include('myapp.urls')),
]
安装:
pip install flask
基础应用:
from flask import Flask, request, jsonify
app = Flask(__name__)
books = [
{"id": 1, "title": "Python编程", "author": "John Doe"},
{"id": 2, "title": "Flask Web开发", "author": "Jane Smith"}
]
@app.route('/books', methods=['GET', 'POST'])
def handle_books():
if request.method == 'GET':
return jsonify(books)
if request.method == 'POST':
new_book = request.json
new_book['id'] = len(books) + 1
books.append(new_book)
return jsonify(new_book), 201
@app.route('/books/' , methods=['GET', 'PUT', 'DELETE'])
def handle_book(book_id):
book = next((b for b in books if b['id'] == book_id), None)
if not book:
return jsonify({"error": "Book not found"}), 404
if request.method == 'GET':
return jsonify(book)
if request.method == 'PUT':
data = request.json
book.update(data)
return jsonify(book)
if request.method == 'DELETE':
books.remove(book)
return '', 204
if __name__ == '__main__':
app.run(debug=True)
安装:
pip install fastapi uvicorn
基础应用:
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
from typing import List
app = FastAPI()
class Book(BaseModel):
title: str
author: str
books_db = [
{"id": 1, "title": "Python编程", "author": "John Doe"},
{"id": 2, "title": "FastAPI开发", "author": "Jane Smith"}
]
@app.get("/books", response_model=List[Book])
async def read_books():
return books_db
@app.post("/books", response_model=Book, status_code=201)
async def create_book(book: Book):
new_book = book.dict()
new_book["id"] = len(books_db) + 1
books_db.append(new_book)
return new_book
@app.get("/books/{book_id}", response_model=Book)
async def read_book(book_id: int):
book = next((b for b in books_db if b["id"] == book_id), None)
if not book:
raise HTTPException(status_code=404, detail="Book not found")
return book
# 自动文档访问:
# - Swagger UI: http://127.0.0.1:8000/docs
# - ReDoc: http://127.0.0.1:8000/redoc
以下是简单基准测试结果 (每秒请求数):
框架 | 同步请求 | 异步请求 |
---|---|---|
Django | ~1,200 | ~3,500 |
Flask | ~1,500 | N/A |
FastAPI | ~2,800 | ~15,000 |
选择 Django 如果:
选择 Flask 如果:
选择 FastAPI 如果:
Django:
Flask:
FastAPI:
每个框架都有其独特的优势和适用场景,选择应根据项目需求、团队熟悉度和长期维护考虑来决定。