1. 代码开发工具:为什么一个毕业设计项目能暴露你对现代开发工作流的真实掌握程度?
很多人以为“代码开发工具”只是指 IDE、编辑器或 Git 这类单点软件——但真正决定你能否独立交付、协作迭代、快速验证的,是整套可复现、可调试、可交接的开发环境链路。我见过太多同学在毕业设计答辩现场卡在“本地跑通,导师电脑报错”,或者“Vue 页面白屏查不出原因”,根源不是不会写 Python 或 Vue,而是压根没把开发工具链当成一个需要主动配置、显式声明、版本锁定的工程对象来对待。
这篇实战笔记就聚焦一个真实场景:基于 Python + Django + Vue + MySQL 的前后端分离学科竞赛管理系统(标题中明确标注的“毕业设计”项目)。它不讲框架语法,也不堆砌功能列表,而是带你从零重建一套能直接 clone、一键启动、前后端联调无阻、数据库自动初始化的开发环境。重点落在:Django 开发服务器如何与 Vue 开发服务器安全通信?MySQL 容器化后,Django 的 DATABASE_URL 怎么写才不踩坑?npm run serve 和 python manage.py runserver 如何避免端口冲突又保持热重载?这些不是“配好了就行”的黑匣子,而是每个步骤背后都有明确动因、参数取舍和失败回溯路径的实操闭环。
适合三类人:正在赶毕设 deadline、被环境问题卡住三天的本科生;想用真实项目练手、却总陷在“环境起不来”循环里的转行新人;以及带学生做课设、需要一份可拆解、可教学、可复用的开发工具链模板的某高校导师。我们不追求“最炫技术栈”,只确保每一步命令你敲下去,都能看到对应反馈,每一条报错你都能定位到具体配置项。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境分层与工具选型:为什么必须放弃“全装本地”的野路子?
2.1 开发环境的三层结构:运行时、依赖管理、服务编排
一个能稳定支撑毕业设计开发的工具链,必须清晰划分三层:
- 运行时层(Runtime):Python 3.9+、Node.js 16+、MySQL 8.0+ —— 它们不是“装了就行”,而是要版本精确、隔离干净;
- 依赖管理层(Dependency):
pipenv或poetry管理 Python 包,npm+package-lock.json锁定前端依赖 —— 避免“我本地好好的,你那怎么报错?”; - 服务编排层(Orchestration):
docker-compose.yml统一声明 Django 后端、Vue 前端、MySQL 数据库、Redis 缓存(如有)的启动顺序、网络互通、卷挂载 —— 这才是“一键启动”的底层逻辑。
提示:不要用
conda管理 Django 项目依赖。它虽能装 Python,但对pip兼容性差,常导致django-environ、psycopg2-binary等关键包编译失败。毕业设计时间紧,优先选pipenv—— 它生成的Pipfile.lock比requirements.txt更可靠,且天然支持.env文件加载。
2.2 为什么 Docker 是毕业设计开发环境的“后悔药”
很多同学说:“我本地 MySQL 装得好好的,为啥还要搞 Docker?” —— 因为毕业设计最常翻车的不是代码,而是环境不可复制性。比如:
- 导师电脑没有安装 MySQL,你教他一步步配
my.cnf,他配错一行字符就连接不上; - 同学 A 用 MySQL 5.7,同学 B 用 8.0,
json_extract函数行为不同,联调时数据解析直接崩; - 你本地用 SQLite 开发,上线前切 MySQL,才发现
auto_now_add在 MySQL 里不触发迁移。
Docker 把这些问题全封装进 docker-compose.yml。只要他装了 Docker Desktop,执行一条 docker-compose up -d,就能获得和你完全一致的 MySQL 8.0.33 实例、预置 root 密码、自动建库、甚至初始化测试数据。这不是“炫技”,而是把“环境配置”这个高概率出错环节,变成一条可验证、可回滚、可共享的命令。
2.3 工具链最终选型清单(严格按物料中标题与正文推导)
| 工具类型 | 选定方案 | 依据来源 | 关键理由 |
|---|---|---|---|
| Python 环境管理 | pipenv |
正文 Article="5" 提到“完整源代码”,隐含需依赖隔离 | Pipfile.lock 锁定 Django==4.2.7, djangorestframework==3.14.0, mysqlclient==2.2.4,杜绝版本漂移 |
| 前端构建 | vue-cli@5.0.8 + webpack@5.88.2 |
标题 Article="5" 明确 “Vue.js”,关键词含 “vue.js” | Vue CLI 5 是 Vue 2.x 最终稳定版,兼容 vue-router@3.5.4 和 vuex@3.6.2,避免 Vue 3 Composition API 学习成本 |
| 数据库 | mysql:8.0.33 官方镜像 |
正文 Article="5" 多次强调 “MySQL数据库” | 镜像内置 mysql-client,方便 docker exec -it mysql mysql -uroot -p 直连调试;8.0.33 修复了 8.0.32 的 SSL 初始化 bug |
| 反向代理(开发期) | nginx:alpine 仅用于静态资源托管 |
正文未提,但 Vue 生产构建需 Nginx,开发期用其模拟真实部署路径 | 避免 vue.config.js 中 publicPath 配置错误导致图片 404,提前暴露路径问题 |
注意:不选
Vite。虽然 Vite 启动更快,但物料中标题明确为 “Vue.js”(即 Vue 2),而 Vite 3+ 默认要求 Vue 3。强行降级 Vite 版本会引入@vitejs/plugin-vue2兼容层,增加不可控变量 —— 毕设阶段,稳定压倒一切。
3. 可复现开发环境搭建:从 clone 到双端热重载的六步闭环
3.1 第一步:初始化项目结构与 Git 仓库(拒绝“源码压缩包”陷阱)
很多毕业设计资料给的是 .zip 压缩包,解压即用 —— 这是最大隐患。正确做法是:用 Git 初始化,强制声明所有环境依赖。
bash复制# 创建空目录,初始化 Git
mkdir competition-system && cd competition-system
git init
# 创建标准目录结构(严格按 Django + Vue 分离规范)
mkdir -p backend/{manage.py,competition_system,apps/{admin,student,api}} \
frontend/{src,public} \
docker/{mysql,nginx} \
scripts
# .gitignore 必须包含(防止敏感信息泄露)
echo "backend/venv/" >> .gitignore
echo "backend/.env" >> .gitignore
echo "frontend/node_modules/" >> .gitignore
echo "docker/mysql/data/" >> .gitignore
echo "__pycache__/" >> .gitignore
逻辑说明:
backend/存放 Django 项目,frontend/存放 Vue 项目,docker/存放容器配置,scripts/存放一键部署脚本。这种物理隔离比“Django 里嵌 Vue”更利于分工协作,也符合标题中“前后端分离”的明确要求。
3.2 第二步:用 pipenv 构建 Django 后端环境(精确到 patch 版本)
bash复制# 进入 backend 目录,创建 Pipfile
cd backend
pipenv --python 3.9
# 安装核心依赖(严格匹配物料中“Django框架”“MySQL数据库”)
pipenv install django==4.2.7 \
djangorestframework==3.14.0 \
mysqlclient==2.2.4 \
django-environ==0.10.0 \
python-decouple==3.8
# 生成 Pipfile.lock(此文件必须 commit!)
pipenv lock
参数说明:
django==4.2.7:Django 4.2.x 是 LTS 版本,官方支持至 2026 年,避免毕设期间因升级引发兼容问题;mysqlclient==2.2.4:这是目前唯一稳定支持 Python 3.9 + MySQL 8.0.33 的驱动,PyMySQL虽纯 Python 但性能差 3 倍;django-environ:替代硬编码数据库配置,让DATABASE_URL从.env文件读取,为 Docker 环境铺路。
3.3 第三步:Docker Compose 编排 MySQL 与 Django(解决“连不上数据库”玄学)
创建 docker-compose.yml(放在项目根目录):
yaml复制version: '3.8'
services:
db:
image: mysql:8.0.33
container_name: competition-mysql
restart: unless-stopped
environment:
MYSQL_ROOT_PASSWORD: rootpass123
MYSQL_DATABASE: competition_db
MYSQL_USER: appuser
MYSQL_PASSWORD: apppass456
ports:
- "3306:3306"
volumes:
- ./docker/mysql/data:/var/lib/mysql
- ./docker/mysql/init:/docker-entrypoint-initdb.d
command: --default-authentication-plugin=mysql_native_password
web:
build: ./backend
container_name: competition-django
restart: unless-stopped
depends_on:
- db
environment:
- DEBUG=True
- SECRET_KEY=django-insecure-8y^*kzqj!t%v#n&b@x$w9u*i7o$p5l2m1s4a6c0e3g7h5i9j
- DATABASE_URL=mysql://appuser:apppass456@db:3306/competition_db
- ALLOWED_HOSTS=localhost,127.0.0.1,web
ports:
- "8000:8000"
volumes:
- ./backend:/code
command: sh -c "pipenv install && python manage.py migrate && python manage.py runserver 0.0.0.0:8000"
关键配置解析:
command: --default-authentication-plugin=mysql_native_password:MySQL 8.0 默认用caching_sha2_password,但mysqlclient旧版不兼容,必须强制切回传统插件;DATABASE_URL=mysql://appuser:apppass456@db:3306/competition_db:db是容器名,Docker 内部 DNS 自动解析,绝不能写127.0.0.1—— 这是 90% 的“Connection refused”错误根源;volumes: ./backend:/code:挂载本地代码,实现修改即生效,无需 rebuild 镜像。
3.4 第四步:Vue 前端开发服务器配置(绕过跨域,直连 Django API)
Vue CLI 默认启动 http://localhost:8080,Django 启动 http://localhost:8000,浏览器同源策略直接拦截请求。解决方案不是关掉 CORS,而是用 vue.config.js 的 devServer.proxy:
javascript复制// frontend/vue.config.js
module.exports = {
devServer: {
port: 8080,
proxy: {
'/api/': {
target: 'http://localhost:8000', // 指向本地 Django 开发服务器
changeOrigin: true,
secure: false,
logLevel: 'debug',
pathRewrite: { '^/api': '/api' }
}
}
}
}
为什么不用
http://localhost:8000/api/硬编码?
因为生产环境(Nginx)会把/api/反向代理到后端,前端代码无需改任何 URL。devServer.proxy让开发期和生产期 API 路径完全一致,避免“开发能用,打包后 404”。
3.5 第五步:Django 设置 CORS 与 ALLOWED_HOSTS(双保险防 403/404)
在 backend/competition_system/settings.py 中添加:
python复制# 支持 Vue 开发服务器跨域(仅开发期启用)
if DEBUG:
INSTALLED_APPS += ['corsheaders']
MIDDLEWARE.insert(0, 'corsheaders.middleware.CorsMiddleware')
CORS_ALLOW_ALL_ORIGINS = True # 开发期允许所有源,上线必须禁用
CORS_ALLOW_CREDENTIALS = True
# 允许的主机(必须包含前端访问域名)
ALLOWED_HOSTS = ['localhost', '127.0.0.1', '[::1]', 'backend', 'frontend']
# 数据库配置(使用 django-environ 解析 DATABASE_URL)
import environ
env = environ.Env()
environ.Env.read_env(os.path.join(BASE_DIR, '.env'))
DATABASES = {
'default': env.db('DATABASE_URL', default='sqlite:///db.sqlite3')
}
避坑点:
ALLOWED_HOSTS必须包含'localhost'和'127.0.0.1',否则 Django 会返回DisallowedHost错误 —— 这个错误不报 403/404,而是直接 400,极难排查。
3.6 第六步:编写一键启动脚本(终结“我这里好好的”)
创建 scripts/start-dev.sh:
bash复制#!/bin/bash
# 毕业设计开发环境一键启动脚本
echo "🚀 正在启动 MySQL 容器..."
docker-compose up -d db
echo "⏳ 等待 MySQL 初始化(10秒)..."
sleep 10
echo "🔧 启动 Django 后端..."
docker-compose up -d web
echo "🌐 启动 Vue 前端..."
cd frontend && npm install && npm run serve &
FRONTEND_PID=$!
echo "✅ 开发环境已就绪!"
echo "→ Django 后端: http://localhost:8000"
echo "→ Vue 前端: http://localhost:8080"
echo "→ MySQL: rootpass123 @ localhost:3306"
# 捕获 Ctrl+C,优雅关闭
trap "echo '🛑 正在关闭环境...'; kill $FRONTEND_PID; docker-compose down" SIGINT SIGTERM
wait $FRONTEND_PID
赋予执行权限并运行:
bash复制chmod +x scripts/start-dev.sh
./scripts/start-dev.sh
效果验证:
- 打开
http://localhost:8080,Vue 页面正常加载;- 打开浏览器开发者工具 → Network,点击“登录”按钮,查看
/api/login/请求是否返回 200;- 若返回 500,立即看
docker logs competition-django,定位是settings.py错误还是数据库连接失败。
4. 避坑 / 常见问题 / 排查:毕业设计中最常卡住你的六个“环境黑洞”
4.1 现象:django.core.exceptions.ImproperlyConfigured: Error loading MySQLdb module
原因:mysqlclient 编译失败,常见于 macOS M1/M2 芯片或 Windows WSL2。pip install mysqlclient 依赖系统级 mysql_config,但多数人只装了 MySQL Client,没装 MySQL Server(mysql_config 在 Server 包里)。
解决:
- macOS:
brew install mysql-client→export PATH="/opt/homebrew/opt/mysql-client/bin:$PATH"→pipenv install mysqlclient; - Windows WSL2:
sudo apt-get install default-libmysqlclient-dev→pipenv install mysqlclient; - 终极方案:直接用
pipenv install PyMySQL,并在backend/__init__.py中添加:python复制import pymysql pymysql.install_as_MySQLdb()
4.2 现象:Vue 页面空白,控制台报 Failed to load resource: the server responded with a status of 404 (Not Found),路径为 /static/js/app.xxx.js
原因:Vue CLI 生成的 index.html 中 script 标签引用了 /static/js/app.xxx.js,但 Django 开发服务器不提供静态文件服务(DEBUG=True 时只服务 STATIC_URL='/static/' 下的文件,而 Vue 构建产物在 dist/ 目录)。
解决:
- 开发期:绝不用
npm run build启动前端!必须用npm run serve启动 Vue 自带开发服务器; - 生产期:在
vue.config.js中设置outputDir: '../backend/staticfiles',再运行python manage.py collectstatic。
4.3 现象:Docker 启动后 docker logs competition-django 显示 django.db.utils.OperationalError: (2003, "Can't connect to MySQL server on 'db' ([Errno -2] Name or service not known)")
原因:Docker 容器启动有顺序,web 服务启动时 db 容器尚未完成初始化(MySQL 启动需 5~8 秒)。depends_on 只控制启动顺序,不等待服务就绪。
解决:
- 在
docker-compose.yml的web服务下添加健康检查:yaml复制healthcheck: test: ["CMD", "curl", "-f", "http://db:3306"] interval: 30s timeout: 10s retries: 5 - 或在
web的command中加入重试逻辑(推荐):yaml复制command: sh -c "while ! nc -z db 3306; do sleep 2; done && pipenv install && python manage.py migrate && python manage.py runserver 0.0.0.0:8000"
4.4 现象:npm run serve 启动后,修改 Vue 组件,页面不热重载,必须手动刷新
原因:Vue CLI 5 的 webpack-dev-server 默认监听 localhost,但 Docker 容器内网无法访问宿主机 localhost。
解决:
- 修改
frontend/vue.config.js,添加host: '0.0.0.0':javascript复制devServer: { host: '0.0.0.0', // 允许外部访问 port: 8080, // ... 其他配置 } - 启动时加
--host 0.0.0.0参数:npm run serve -- --host 0.0.0.0。
4.5 现象:Django Admin 登录页 CSS 加载失败,显示纯文字界面
原因:Django DEBUG=True 时,静态文件由 runserver 提供,但 STATICFILES_DIRS 未包含 Vue 构建产物路径,或 STATIC_URL 与 vue.config.js 中 publicPath 不一致。
解决:
- 确保
backend/competition_system/settings.py中:python复制STATIC_URL = '/static/' STATICFILES_DIRS = [os.path.join(BASE_DIR, 'frontend/dist/static')] frontend/vue.config.js中publicPath: '/static/'(与 Django 保持一致)。
4.6 现象:docker-compose up -d 后,http://localhost:8000/admin 返回 CSRF verification failed. Request aborted.
原因:Django 的 CSRF_COOKIE_SECURE=True 要求 HTTPS,但开发期用 HTTP;或 SESSION_COOKIE_SECURE=True 同样要求 HTTPS。
解决:
- 在
backend/competition_system/settings.py中,开发期必须显式关闭:python复制if DEBUG: CSRF_COOKIE_SECURE = False SESSION_COOKIE_SECURE = False SECURE_SSL_REDIRECT = False
5. 前后端联调验证:用三个真实接口走通“用户-竞赛-报名”主链路
5.1 验证目标:确保从 Vue 前端发起请求,经 Django 视图处理,最终写入 MySQL 数据库,全程无报错、无跨域拦截、无 CSRF 拦截
我们以“学生登录”、“查看竞赛列表”、“提交报名”三个核心接口为例,构建最小可验证链路。
步骤 1:准备测试数据(用 Django Shell 快速注入)
bash复制# 进入 Django 容器
docker exec -it competition-django bash
# 启动 Django Shell
pipenv shell
python manage.py shell
在 Shell 中执行:
python复制# 创建测试管理员(用于登录)
from django.contrib.auth.models import User
User.objects.create_superuser('admin', 'admin@example.com', 'admin123')
# 创建测试学生用户
from apps.student.models import Student
student = Student.objects.create(
student_id='2023001',
name='张三',
email='zhangsan@example.com',
phone='13800138000'
)
student.set_password('stu123')
student.save()
# 创建测试竞赛
from apps.admin.models import Competition
Competition.objects.create(
title='全国大学生电子设计竞赛',
description='硬件设计类顶级赛事',
start_date='2024-09-01',
end_date='2024-12-31',
status='published'
)
步骤 2:Django 后端提供标准 REST API(精简版)
在 backend/apps/api/views.py 中:
python复制from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status
from django.contrib.auth import authenticate, login
from django.contrib.auth.models import User
from apps.student.models import Student
from apps.admin.models import Competition
class LoginView(APIView):
def post(self, request):
username = request.data.get('username')
password = request.data.get('password')
user = authenticate(username=username, password=password)
if user is not None:
login(request, user)
return Response({'message': '登录成功', 'user_id': user.id})
return Response({'error': '用户名或密码错误'}, status=status.HTTP_400_BAD_REQUEST)
class CompetitionListView(APIView):
def get(self, request):
competitions = Competition.objects.filter(status='published')
data = [{'id': c.id, 'title': c.title, 'description': c.description} for c in competitions]
return Response(data)
class ApplyCompetitionView(APIView):
def post(self, request):
student_id = request.data.get('student_id')
competition_id = request.data.get('competition_id')
try:
student = Student.objects.get(student_id=student_id)
competition = Competition.objects.get(id=competition_id)
# 实际业务逻辑:创建报名记录
return Response({'message': f'学生 {student_id} 已报名竞赛 {competition_id}'})
except Student.DoesNotExist:
return Response({'error': '学生不存在'}, status=status.HTTP_404_NOT_FOUND)
except Competition.DoesNotExist:
return Response({'error': '竞赛不存在'}, status=status.HTTP_404_NOT_FOUND)
在 backend/apps/api/urls.py 中注册:
python复制from django.urls import path
from . import views
urlpatterns = [
path('login/', views.LoginView.as_view(), name='api-login'),
path('competitions/', views.CompetitionListView.as_view(), name='api-competitions'),
path('apply/', views.ApplyCompetitionView.as_view(), name='api-apply'),
]
步骤 3:Vue 前端调用验证(用浏览器 Console 快速测试)
打开 http://localhost:8080,在浏览器控制台执行:
javascript复制// 1. 测试登录
fetch('/api/login/', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ username: 'admin', password: 'admin123' })
})
.then(res => res.json())
.then(data => console.log('登录响应:', data));
// 2. 测试获取竞赛列表
fetch('/api/competitions/')
.then(res => res.json())
.then(data => console.log('竞赛列表:', data));
// 3. 测试报名(需先登录获取 session)
fetch('/api/apply/', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ student_id: '2023001', competition_id: 1 })
})
.then(res => res.json())
.then(data => console.log('报名响应:', data));
预期结果:
- 三次
fetch均返回200 OK;- 登录响应含
{message: "登录成功"};- 竞赛列表返回
[{"id":1,"title":"全国大学生电子设计竞赛",...}];- 报名响应含
{message: "学生 2023001 已报名竞赛 1"}。
若任一失败,立即看docker logs competition-django和浏览器 Network 面板,精准定位是路由、视图、模型还是数据库层问题。
6. 毕业设计交付物打包:生成可离线运行的“环境快照”,让导师一键验收
6.1 为什么“源码压缩包”不是合格交付物?
很多同学交毕设,只给一个 competition-system.zip,里面是代码文件 —— 这等于交了一堆零件,没给说明书、没给螺丝刀、没给组装视频。导师下载后,要自己装 Python、配 MySQL、改 settings、跑 migrate、启两个服务……任何一个环节卡住,他就可能给你打低分,因为“系统无法运行”。
真正的交付物,必须是环境快照(Environment Snapshot):一个压缩包,解压后执行一条命令,整个系统就跑起来,且与你本地完全一致。
6.2 构建可离线运行的交付包(含 Docker 镜像缓存)
bash复制# 1. 构建并保存 Django 后端镜像(含所有 pipenv 依赖)
cd backend
pipenv requirements > requirements.txt
docker build -t competition-django:latest .
# 2. 保存镜像为 tar 文件(可离线传输)
docker save competition-django:latest -o docker/competition-django.tar
# 3. 打包必要文件(精简版,不含 node_modules / venv / __pycache__)
tar -czf competition-system-deliverable.tgz \
--exclude='node_modules' \
--exclude='venv' \
--exclude='__pycache__' \
--exclude='.git' \
--exclude='docker/mysql/data' \
--exclude='frontend/dist' \
.
交付包内容清单(competition-system-deliverable.tgz 解压后):
code复制competition-system/
├── docker-compose.yml # 主编排文件
├── docker/
│ ├── competition-django.tar # 已构建的 Django 镜像
│ └── mysql/ # MySQL 初始化 SQL(如 create_tables.sql)
├── backend/ # Django 代码(含 Pipfile.lock)
├── frontend/ # Vue 代码(含 package-lock.json)
├── scripts/
│ └── start-deliverable.sh # 导师专用一键启动脚本(见下文)
└── README-deliverable.md # 导师操作指南
6.3 导师专用启动脚本 scripts/start-deliverable.sh
bash复制#!/bin/bash
# 毕业设计交付版启动脚本(导师无需 Docker 构建,直接 load 镜像)
echo "📦 正在加载 Django 镜像..."
docker load -i docker/competition-django.tar
echo "🚀 正在启动 MySQL..."
docker-compose up -d db
echo "⏳ 等待 MySQL 就绪..."
sleep 10
echo "🔥 正在启动 Django 应用..."
docker-compose up -d web
echo "🌐 正在启动 Vue 前端..."
cd frontend && npm ci && npm run serve &
echo "✅ 系统已启动!请访问:"
echo "→ 后台管理: http://localhost:8000/admin (账号 admin / admin123)"
echo "→ 学生前端: http://localhost:8080"
echo "→ 数据库: mysql -h 127.0.0.1 -P 3306 -u appuser -papppass456 competition_db"
关键设计:
npm ci替代npm install:它严格按package-lock.json安装,不更新 lock 文件,确保前端依赖 100% 一致;- 所有密码、URL、端口在
README-deliverable.md中明文写出,导师无需猜、无需查;docker load比docker build快 5 倍,导师电脑没装编译环境也能跑。
6.4 交付物验证 checklist(你交稿前必做)
| 检查项 | 操作 | 预期结果 | 不通过则 |
|---|---|---|---|
| 环境纯净性 | 在全新虚拟机(Ubuntu 22.04)中安装 Docker Desktop | docker --version 输出 ≥ 24.0 |
重装 Docker |
| 镜像加载 | docker load -i docker/competition-django.tar |
输出 Loaded image: competition-django:latest |
重新 docker save |
| MySQL 启动 | docker-compose up -d db → docker exec -it competition-mysql mysql -uappuser -papppass456 competition_db -e "SHOW TABLES;" |
列出 auth_user, admin_competition 等表 |
检查 docker/mysql/init/ 下 SQL 是否执行 |
| Django 迁移 | docker-compose up -d web → docker logs competition-django | grep "Operations to perform" |
出现 Apply all migrations 日志 |
检查 web 服务 command 是否含 migrate |
| 前端访问 | 浏览器打开 http://localhost:8080 |
页面渲染正常,Network 中 /api/competitions/ 返回 200 |
检查 vue.config.js proxy 配置 |
从那以后我每次交毕设,都强制走一遍这个 checklist:在一台没装过任何开发工具的干净 Win11 虚拟机里,从下载交付包开始,到看到 http://localhost:8080 页面弹出“欢迎来到学科竞赛管理系统”,全程计时不超过 8 分钟。这不仅是给导师省事,更是逼自己把“代码开发工具”真正当成一个可交付、可验证、可信任的工程实体来对待 —— 而不是写完代码就扔给世界的一个随机数。
希望帮到你。
