源码交付:能在干净电脑按文档跑起来

发布于 2026-09-16 · 作者 babachen · Java / Vue / 小程序通用
毕业设计源码交付清单

临交材料最常见翻车:U 盘里塞了 2GB 的 node_modules、密码写在配置里、没有 SQL、部署说明只有「用 IDEA 打开」。老师换台电脑打不开,等于没交。测试表见 8 条用例;答辩环境备份见 3 分钟脚本。本页只解决:交什么、怎么打包、怎么自测。

合格线:压缩包 < 80MB(不含依赖目录);配置无真实密码;SQL 能建库并登录两个角色;docs/部署说明.md 按步骤能启动。你自己在另一台电脑或新文件夹复现过一次。

一、压缩包里只放这些

your-project/
  backend/          # Spring Boot 源码,无 target/
  frontend/         # Vue 源码,无 node_modules/ dist/
  sql/
    schema.sql      # 建表
    demo-data.sql   # 演示账号和主流程数据
  docs/
    部署说明.md
    账号.txt
  screenshots/      # 登录、主流程、统计、ER
  README.md         # 一句话题目 + 指向部署说明

小程序把 miniprogram/ 放进来,体验版二维码截图放 screenshots/。Android 交源码 + 已签名 APK,不要只交 APK。

二、必须删掉的

删为什么
node_modules/ target/ dist/体积和本机路径,换电脑必坏
.idea/ .vscode/ 个人配置泄露本机路径
真实密码、云密钥、微信 AppSecret安全事故;用 your-password 占位
论文 Word、查重报告另交教务系统,别混进源码包
别人的完整电商模板未用模块答辩被打开会穿帮

配置示例只保留:

spring.datasource.url=jdbc:mysql://127.0.0.1:3306/bysj_demo
spring.datasource.username=root
spring.datasource.password=your-password

三、部署说明最少 8 行(可复制改)

  1. 环境:JDK 17 / Maven 3.9 / MySQL 8 / Node 18(写你真实用的)
  2. 建库:CREATE DATABASE bysj_demo DEFAULT CHARSET utf8mb4;
  3. 导入 sql/schema.sql 再导入 sql/demo-data.sql
  4. 改 application.yml 里的库名和密码
  5. 后端:mvn spring-boot:run 或 IDEA 运行主类
  6. 前端:npm i 后 npm run dev,访问文档里的地址
  7. 账号:学生 student / 123456,管理员 admin / 123456(演示专用)
  8. 主流程:登录 → 提交一条 → 管理员审核 → 看统计页

主流程必须和第 3 分钟演示一致,见 演示脚本。库表名和开题清单一致,见 4 张核心表。

四、SQL 里至少有什么

不要交空库让老师自己点。中期如果已经有演示数据,终期沿用同一套,见 中期清单。

五、干净电脑自测(交之前 30 分钟)

  1. 解压到新路径,不要用原来的工程目录
  2. 按部署说明逐步做,不凭记忆
  3. 卡住的第一步改文档,不要口头补
  4. 能登录并走完主流程再打 zip
  5. zip 名:专业-姓名-题目简称-源码.zip

这和测试用例互补:用例证明功能对,交付包证明别人能跑。论文第 6 章可附「测试环境与本文档一致」一句,见 论文结构。

六、常见翻车

做法后果改法
整盘复制 C 盘工程路径、密钥、2GB 垃圾按上表重装一份
只有前端没有后端演示假数据两端都交,端口写清
SQL 是 Navicat 连接信息截图导不进去导出 .sql 文本
说明写「自己百度」直接退回8 行步骤
微信密钥写进仓库安全问题占位符 + 说明去公众平台填

常见问题

学院要求交 Git 仓库怎么办?

同样清密钥。README 指向部署说明。不要把 node_modules 提交进 Git。

必须买云服务器吗?

不是。答辩本机即可。若老师要公网,再用低配云或内网穿透,配置不要写进交付包的真实密钥。

Python / Django 有什么不同?

交 requirements.txt + python manage.py migrate 步骤。虚拟环境目录不要打包。

交了还会被说跑不起来?

多半是版本没写死。JDK、Node、MySQL 三个版本抄到文档第一行。

打包前把目录截图发过来

帮你看缺不缺 SQL 和密钥。微信 cqlhsa123。

立即免费咨询