Python与前端集成：构建全栈应用

作者：暮色微凉时间：2026-06-26 来源：正软商城浏览：2

前言非科班转码，同时学习Rust和Python，最近开始探索Python与前端技术的集成。乍一看全栈开发的概念确实有些模糊，但深入后发现，Python作为后端与前端框架结合，完全能构建出功能强大的全栈应用。下面分享一些实操心得，希望能给同样在转码路上的朋友提供些参考。一、后端API设计 1.1

本文目录

前言

非科班转码，同时学习Rust和Python，最近开始探索Python与前端技术的集成。乍一看全栈开发的概念确实有些模糊，但深入后发现，Python作为后端与前端框架结合，完全能构建出功能强大的全栈应用。下面分享一些实操心得，希望能给同样在转码路上的朋友提供些参考。

Python与前端集成：构建全栈应用

一、后端API设计

1.1 使用FastAPI创建RESTful API

FastAPI算是当前Python Web框架里的新星，用来搭RESTful API非常顺手：

from fastapi import FastAPI
from pydantic import BaseModel
from typing import List

app = FastAPI()

class Item(BaseModel):
    id: int
    name: str
    price: float
    is_offer: bool = None

items = []

@app.get("/")
def read_root():
    return {"message": "Hello, World!"}

@app.get("/items/{item_id}")
def read_item(item_id: int):
    for item in items:
        if item.id == item_id:
            return item
    return {"error": "Item not found"}

@app.post("/items/")
def create_item(item: Item):
    items.append(item)
    return item

@app.put("/items/{item_id}")
def update_item(item_id: int, item: Item):
    for i, existing_item in enumerate(items):
        if existing_item.id == item_id:
            items[i] = item
            return item
    return {"error": "Item not found"}

@app.delete("/items/{item_id}")
def delete_item(item_id: int):
    for i, item in enumerate(items):
        if item.id == item_id:
            items.pop(i)
            return {"message": "Item deleted"}
    return {"error": "Item not found"}

1.2 使用Flask创建RESTful API

Flask作为老牌框架，同样能胜任RESTful API的搭建：

from flask import Flask, request, jsonify

app = Flask(__name__)

items = []

@app.route('/', methods=['GET'])
def read_root():
    return jsonify({"message": "Hello, World!"})

@app.route('/items/', methods=['GET'])
def read_item(item_id):
    for item in items:
        if item['id'] == item_id:
            return jsonify(item)
    return jsonify({"error": "Item not found"})

@app.route('/items/', methods=['POST'])
def create_item():
    item = request.get_json()
    items.append(item)
    return jsonify(item)

@app.route('/items/', methods=['PUT'])
def update_item(item_id):
    item = request.get_json()
    for i, existing_item in enumerate(items):
        if existing_item['id'] == item_id:
            items[i] = item
            return jsonify(item)
    return jsonify({"error": "Item not found"})

@app.route('/items/', methods=['DELETE'])
def delete_item(item_id):
    for i, item in enumerate(items):
        if item['id'] == item_id:
            items.pop(i)
            return jsonify({"message": "Item deleted"})
    return jsonify({"error": "Item not found"})

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

二、前端框架集成

2.1 与React集成

React作为前端主流框架，与Python后端对接的方式很直接：

// App.js
import React, { useState, useEffect } from 'react';

function App() {
  const [items, setItems] = useState([]);
  const [newItem, setNewItem] = useState({ id: '', name: '', price: '', is_offer: false });

  useEffect(() => {
    fetch('http://localhost:8000/items/')
      .then(response => response.json())
      .then(data => setItems(data));
  }, []);

  const handleSubmit = (e) => {
    e.preventDefault();
    fetch('http://localhost:8000/items/', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(newItem),
    })
      .then(response => response.json())
      .then(data => {
        setItems([...items, data]);
        setNewItem({ id: '', name: '', price: '', is_offer: false });
      });
  };

  return (
    
      Items
      
        {items.map(item => (
          
            {item.name} - ${item.price}
          
        ))}
      
      
         setNewItem({...newItem, id: parseInt(e.target.value)})}
        />
         setNewItem({...newItem, name: e.target.value})}
        />
         setNewItem({...newItem, price: parseFloat(e.target.value)})}
        />
        
      
    
  );
}

export default App;

2.2 与Vue集成

Vue同样可以无缝对接Python后端，代码风格上更简洁一些：

三、数据传输

3.1 JSON数据格式

前后端之间的数据流通，JSON是绝对的标配：

# 后端返回JSON数据
from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class Item(BaseModel):
    id: int
    name: str
    price: float

@app.get("/item", response_model=Item)
def get_item():
    return {"id": 1, "name": "Item 1", "price": 10.99}

3.2 处理CORS

跨域资源共享（CORS）是前后端集成时绕不开的坎，配置起来其实很简单：

# FastAPI处理CORS
from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware

app = FastAPI()

# 配置CORS
app.add_middleware(
    CORSMiddleware,
    allow_origins=["*"],  # 在生产环境中应该设置具体的域名
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

@app.get("/")
def read_root():
    return {"message": "Hello, World!"}

# Flask处理CORS
from flask import Flask, jsonify
from flask_cors import CORS

app = Flask(__name__)
CORS(app)  # 允许所有跨域请求

@app.route('/')
def read_root():
    return jsonify({"message": "Hello, World!"})

四、认证与授权

4.1 JWT认证

JSON Web Token（JWT）是目前最常用的认证方式之一，下面用FastAPI给出完整示例：

# FastAPI中使用JWT
from fastapi import FastAPI, Depends, HTTPException, status
from fastapi.security import OAuth2PasswordBearer, OAuth2PasswordRequestForm
from jose import JWTError, jwt
from datetime import datetime, timedelta
from pydantic import BaseModel

app = FastAPI()

# 配置
SECRET_KEY = "your-secret-key"
ALGORITHM = "HS256"
ACCESS_TOKEN_EXPIRE_MINUTES = 30

# 模拟用户数据库
fake_users_db = {
    "alice": {
        "username": "alice",
        "full_name": "Alice Smith",
        "email": "alice@example.com",
        "hashed_password": "fakehashedsecret",
        "disabled": False,
    }
}

# 工具函数
def fake_hash_password(password: str):
    return "fakehashed" + password

def verify_password(plain_password, hashed_password):
    return hashed_password == fake_hash_password(plain_password)

def get_user(db, username: str):
    if username in db:
        user_dict = db[username]
        return user_dict

def create_access_token(data: dict, expires_delta: timedelta = None):
    to_encode = data.copy()
    if expires_delta:
        expire = datetime.utcnow() + expires_delta
    else:
        expire = datetime.utcnow() + timedelta(minutes=15)
    to_encode.update({"exp": expire})
    encoded_jwt = jwt.encode(to_encode, SECRET_KEY, algorithm=ALGORITHM)
    return encoded_jwt

# 依赖
oauth2_scheme = OAuth2PasswordBearer(tokenUrl="token")

async def get_current_user(token: str = Depends(oauth2_scheme)):
    credentials_exception = HTTPException(
        status_code=status.HTTP_401_UNAUTHORIZED,
        detail="Could not validate credentials",
        headers={"WWW-Authenticate": "Bearer"},
    )
    try:
        payload = jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM])
        username: str = payload.get("sub")
        if username is None:
            raise credentials_exception
    except JWTError:
        raise credentials_exception
    user = get_user(fake_users_db, username=username)
    if user is None:
        raise credentials_exception
    return user

# 路由
@app.post("/token")
async def login(form_data: OAuth2PasswordRequestForm = Depends()):
    user = get_user(fake_users_db, form_data.username)
    if not user:
        raise HTTPException(status_code=400, detail="Incorrect username or password")
    if not verify_password(form_data.password, user["hashed_password"]):
        raise HTTPException(status_code=400, detail="Incorrect username or password")
    access_token_expires = timedelta(minutes=ACCESS_TOKEN_EXPIRE_MINUTES)
    access_token = create_access_token(
        data={"sub": user["username"]}, expires_delta=access_token_expires
    )
    return {"access_token": access_token, "token_type": "bearer"}

@app.get("/users/me")
async def read_users_me(current_user: dict = Depends(get_current_user)):
    return current_user

五、部署

5.1 部署后端

用Docker来容器化Python后端，操作起来稳定又方便：

# Dockerfile
FROM python:3.9-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY . .

EXPOSE 8000

CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "8000"]

5.2 部署前端

前端部署可以交给Vercel、Netlify这类平台，省心省力：

Vercel：适合部署React、Next.js应用
Netlify：适合部署Vue、React应用
GitHub Pages：适合部署静态网站

5.3 完整部署

使用Docker Compose可以一键拉起前后端服务：

# docker-compose.yml
version: '3'
services:
  backend:
    build: ./backend
    ports:
      - "8000:8000"
  frontend:
    build: ./frontend
    ports:
      - "3000:3000"
    depends_on:
      - backend