青戈带小白做毕设资源：从零搭建可复用的毕业设计实战框架-程序员充电站

青戈带小白做毕设资源：从零搭建可复用的毕业设计实战框架

适用人群：被导师一句“系统要有创新点”整不会了的大四党
目标：两周内跑通一套能答辩、能演示、还能写在简历上的“最小可用毕设”

1. 先把痛点点出来——别让毕设死在起跑线上

和去年带过的 30 多位同学聊完，发现大家踩的坑高度重合，先列个“死亡清单”，你对号入座：

环境配置混乱：Python 3.8/3.9 混用，Node 版本冲突，队友电脑跑不起来直接“甩锅”
前后端黏在一起：HTML 文件里写 SQL，改个字段全项目全局搜索，一跑全是 500
0 测试、0 日志：答辩现场评委一句“你演示一下异常流”直接社死
仓库像垃圾堆：git message 只有“fix”，回滚找不到节点，导师看代码当场皱眉

2. 技术栈选型——别追新，先求“能跑+能改”

毕业设计不是技术竞标，稳定+文档全才是硬道理。下面给出“青戈组合”——两年验证下来答辩通过率 90% 以上。

场景	青戈推荐	理由	可替代方案
后端	Flask 2.x + SQLAlchemy	轻量、蓝本易拆、ORM 改字段快	Django（太重，但自带后台）
前端	Vue3 + ElementPlus	单文件组件易上手、UI 组件拿来即用	React（函数式+Hook 学习曲线高）
数据库	MySQL 8.0 / PostgreSQL14	云厂商免费额度足，教程多	SQLite（本地爽，部署崩）
部署	Docker + Gunicorn + Nginx	一键镜像、校内服务器也能跑	Heroku/Render.io（免费但冷启动慢）

3. 可复用项目骨架——直接 git clone 就能开写

仓库结构（已开源在 GitHub，搜 qingge-bishe-skeleton）：

bishe-skeleton/ ├── backend/ │ ├── app/ │ │ ├── api/ # REST 蓝本 │ │ ├── auth/ # JWT 登录封装 │ │ ├── models/ # SQLAlchemy 模型 │ │ └── utils/ # 通用工具（分页、验证码） │ ├── migrations/ # Flask-Migrate 自动迁移 │ ├── tests/ # pytest 单元测试 │ ├── .env.example # 环境变量模板 │ └── requirements.txt ├── frontend/ │ ├── src/ │ │ ├── api/ # Axios 统一拦截 │ │ ├── router/ # 路由守卫+动态菜单 │ │ ├── stores/ # Pinia 全局状态 │ │ └── views/ # 页面级组件 │ └── vite.config.js ├── docker-compose.yml # 一键起 MySQL+Redis+后端 └── README.md # 保姆级启动命令

3.1 核心代码片段（后端）

用户模型：自带软删除、时间戳基类

# backend/app/models/base.py from datetime import datetime from sqlalchemy import Column, DateTime, Boolean class BaseModel(db.Model): __abstract__ = True created_at = Column(DateTime, default=datetime.utcnow) updated_at = Column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow) is_deleted = Column(Boolean, default=False) # 软删除

JWT 登录逻辑：密码用 bcrypt 哈希，过期时间放配置

# backend/app/auth/routes.py from flask_jwt_extended import create_access_token from passlib.hash import bcrypt @auth_bp.route('/login', methods=['POST']) def login(): data = request.get_json() user = User.query.filter_by(email=data['email']).first() if not user or not bcrypt.verify(data['password'], user.password): return jsonify(msg='邮箱或密码错误'), 401 token = create_access_token(identity=user.id, expires_delta=timedelta(hours=2)) return jsonify(token=token, user=user.to_dict()), 200

全局异常捕获：统一返回格式，前端好判断

# backend/app/api/error.py from flask import jsonify def register_errors(app): @app.errorhandler(404) def not_found(e): return jsonify(code=404, msg='资源不存在'), 404

3.2 前端拦截器——统一弹错+Token 续期

// frontend/src/api/interceptor.js axios.interceptors.response.use( res => res.data, err => { ElMessage.error(err.response?.data?.msg || '服务异常') if (err.response?.status === 401) { router.push('/login') } return Promise.reject(err) } )

4. 部署与演示——让评委手机也能扫码即访问

本地自测

cd bishe-skeleton cp backend/.env.example backend/.env # 改数据库密码 docker-compose up -d

浏览器打开 http://localhost:5173 见登录页即成功。

免费云端方案（以 Railway 为例）
- 把 Dockerfile 推到 GitHub，Railway 自动构建
- 环境变量里填JWT_SECRET_KEY与DATABASE_URL
- 自定义域名：https://bishe-xx.railway.app，答辩现场直接二维码扫码，评委手机可看
演示小技巧
- 录屏 30 秒 GIF 放 PPT，防止现场 4G 信号翻车
- 准备 3 条测试账号写在 README，评委想“玩”直接给
- 提前在后台埋 3 条假数据，别让数据库空着

5. 性能与安全——别让小疏忽毁了三个月心血

SQL 注入：SQLAlchemy 已 ORM 参数化，禁止手写拼接
密码哈希：bcrypt + 12 轮 cost，彩虹表基本失效
限流：Flask-Limiter 对登录接口 5 次/分钟，防暴力破解
前端 XSS：Vue 默认转义，{{}} 内不要 v-html 用户输入
日志：使用 Python logging 的 RotatingFileHandler，保留 7 天，排错不丢盘

6. 生产环境避坑指南——导师与 Git 都开心

Git 提交规范
类型: 简短描述
feat: 新增选题接口
fix: 修复注册验证码失效
docs: 更新 README 启动命令
分支模型
main（保护分支）← develop ← feature/xxx
答辩前建release/v1.0分支，仅修 BUG，不新增功能，保证稳定
答辩 PPT 结构（10 页以内）
1. 项目背景与意义
2. 系统功能架构图
3. 技术栈与选型理由
4. 数据库 ER 图（放一张即可）
5. 核心流程演示（GIF）
6. 创新点 & 展望
7. 致谢