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

Python毕业设计避坑指南：从选题到部署的全流程实战

news 2026/4/14 0:14:00

背景痛点：为什么“炫酷”≠“能过”

每年 3 月，实验室的打印机就开始冒烟：同学们抱着一摞“基于深度学习+区块链+元宇宙”的标书，信心满满地准备改变世界。到了 5 月，却集体在答辩室门口排队删库跑路。
我当年也一样，把毕设当成“技术大杂烩”，结果：

把 PyTorch、Vue、Redis、Docker 全堆进去，最后连“登录”都跑不到底；
代码全写在main.py，一个文件 3000 行，老师打开后直接劝退；
本地跑得好好的，搬到云服务器就 502，日志里只有一行Error: Error。

血泪教训：毕设不是“炫技大会”，而是“工程能力体检”。能跑、能改、能部署，才是及格线。

技术选型：Flask vs Django——别让框架替你写论文

先放结论：
小型毕设、时间紧、人手少 → Flask；
后台功能多、后台管理刚需 → Django。

维度	Flask	Django
学习曲线	3 天能跑通	一周看懂 MTV
代码量	自己写，灵活	生成 admin、auth
第三方插	想配啥配啥	官方全家桶
毕设常见坑	蓝图划分乱	settings 配错

一句话：想快速出 MVP，用 Flask；想少写后台，用 Django。下文以 Flask 演示，Django 同学把urls.py换成urls.py即可。

核心实现：一个“待办事项”拆给你看

功能一句话：用户注册、登录、增删改查自己的任务。
工程目标：目录清晰、可单元测试、老师能秒懂。

1. 目录先搭好

todo/ ├── app/ │ ├── __init__.py │ ├── models.py │ ├── routes.py │ ├── auth.py │ └── utils.py ├── migrations/ ├── tests/ ├── requirements.txt └── run.py

2. 数据模型（SQLAlchemy）

# app/models.py from datetime import datetime from typing import Optional from flask_sqlalchemy import SQLAlchemy from flask_login import UserMixin db = SQLAlchemy() class User(UserMixin, db.Model): id: int = db.Column(db.Integer, primary_key=True) username: str = db.Column(db.String(64), unique=True, nullable=False) password_hash: str = db.Column(db.String(128), nullable=False) class Task(db.Model): id: int = db.Column(db.Integer, primary_key=True) body: str = db.Column(db.String(200), nullable=False) done: bool = db.Column(db.Boolean, default=False) user_id: int = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False) create_time: datetime = db.Column(db.DateTime, default=datetime.utcnow)

3. 业务逻辑（services 抽离）

# app/utils.py from werkzeug.security import generate_password_hash, check_password_hash def hash_password(plain_pwd: str) -> str: return generate_password_hash(plain_pwd) def verify_password(pwd_hash: str, plain_pwd: str) -> bool: return check_password_hash(pwd_hash, plain_pwd)

4. 路由与视图（只贴关键段）

# app/routes.py from flask import Blueprint, request, jsonify from flask_login import login_required, current_user from app import db from app.models import Task bp = Blueprint('task', __name__, url_prefix='/api') @bp.route('/tasks', methods=['GET']) @login_required def list_tasks(): tasks = Task.query.filter_by(user_id=current_user.id).all() return jsonify([{'id': t.id, 'body': t.body, 'done': t.done} for t in tasks]) @bp.route('/tasks', methods=['POST']) @login_required def add_task(): data = request.get_json() if not data or not data.get('body'): return jsonify({'msg': 'body required'}), 400 t = Task(body=data['body'], user_id=current_user.id) db.session.add(t) db.session.commit() return jsonify({'id': t.id}), 201

5. 启动文件

# run.py from flask import Flask from app import create_app app = create_app('dev') if __name__ == '__main__': app.run()

Clean Code 三件套：

类型提示：pyright 不飘红；
函数<20 行：一眼看完；
注释写“为什么”而不是“是什么”。

部署实践：把“能跑”变成“能上线”

1. 本地先跑通

python -m venv venv source venv/bin/activate pip install -r requirements.txt flask db upgrade python run.py

2. 生产级 WSGI 服务器

pip install gunicorn gunicorn -w 4 -b 0.0.0.0:8000 'app:create_app("prod")'

3. Nginx 反向代理

server { listen 80; server_name your.domain; location / { proxy_pass http://127.0.0.1:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }