快速开始
作者: luote (luote) · 个人主页 luote996.cn
环境要求
| 工具 | 版本 |
|---|---|
| Node.js | >= 18 |
| JDK | 17 |
| Maven | 3.8+ |
| MySQL | 8.x |
| Redis | 6.x+ |
创建项目
bash
npm create luote脚手架启动时会自动查询 npm 上的最新版本；若本地是旧版（npx 缓存），会自动用最新版重新执行，无需手写 @latest。
离线或本地调试时可跳过检查：
bash
set CREATE_LUOTE_SKIP_UPDATE=1
npm create luote交互式流程默认项目名为 luote-app，回车即可创建：
luote-app/
├── luote-app-backend/
└── luote-app-front/也可直接指定项目名：
bash
npm create luote my-app将生成 my-app/my-app-backend 与 my-app/my-app-front。
启动后端
bash
cd luote-app/luote-app-backend
# Windows
copy .env.example .env
# macOS / Linux
# cp .env.example .env
mvn spring-boot:run首次启动前请执行 data.sql 初始化 luote 库与 users 表。
默认接口地址：http://localhost:8080
Swagger 文档：http://localhost:8080/swagger-ui.html
启动前端
bash
cd luote-app/luote-app-front
npm install
npm run dev默认访问地址：http://localhost:5173
默认账号
| 字段 | 值 |
|---|---|
| 用户名 | admin |
| 密码 | admin123 |
常见问题
验证码不显示
检查后端是否启动、前端 .env.development 中 VITE_API_BASE_URL 是否指向后端。
登录失败
确认 MySQL、Redis 已启动，.env 中数据库与 Redis 配置正确。