classmanament

课程管理系统 — 学生信息管理模块（前后端分离：Go (Gin) + MySQL + Vue 3 (Element Plus)）

功能

• 学生列表（分页）
• 按学号 / 姓名 / 班级搜索
• 新增、编辑、删除学生
• 学号唯一校验

项目结构

student-management/
├── backend/          # Go HTTP API
├── frontend/         # Vue 3 前端
├── scripts/init.sql  # 数据库初始化
├── 知识总结/         # 学习笔记（含 git命令/）
└── docker-compose.yml

快速开始

1. 准备 MySQL

方式 A：Docker（推荐）

cd student-management
docker compose up -d

方式 B：本地 MySQL

在 MySQL 客户端执行：

mysql -u root -p < scripts/init.sql

2. 启动后端

cd backend
go mod tidy
# Windows PowerShell 设置密码（按你的实际密码修改）
$env:DB_PASSWORD="root"
go run .

服务地址：http://localhost:8080

3. 启动前端

cd frontend
npm install
npm run dev

浏览器打开：http://localhost:5173

API 接口

方法	路径	说明
GET	/api/health	健康检查
GET	/api/students?page=1&page_size=10&keyword=	列表
GET	/api/students/:id	详情
POST	/api/students	新增
PUT	/api/students/:id	更新
DELETE	/api/students/:id	删除

请求体示例

{
  "student_no": "2024010",
  "name": "赵六",
  "gender": "男",
  "age": 20,
  "class_name": "计算机2401",
  "phone": "13800000010",
  "email": "zhao@example.com"
}

环境变量

变量	默认值	说明
PORT	8080	API 端口
DB_HOST	127.0.0.1	MySQL 主机
DB_PORT	3306	MySQL 端口
DB_USER	root	用户名
DB_PASSWORD	root	密码
DB_NAME	student_mgmt	数据库名

文档与知识总结

• 知识总结/ — 学习笔记目录
• Git 流程与命令操作说明
• Git 命令说明（上传实操）

常见问题

1. 前端显示「加载失败」：先确认后端 go run . 已启动，且 MySQL 可连接。
2. 学号重复：学号字段有唯一约束，请换一个新学号。
3. 端口占用：修改 PORT 或 vite.config.js 中的 server.port。