Vue3 + Spring Boot 前后端分离项目搭建

前言:Vue3 + Spring Boot 前后端分离项目搭建说明

在机器人设备管理平台等场景中,前后端分离的架构已成为主流选择。本项目旨在通过 Vue3 + Element Plus 实现前端控制界面,结合 Spring Boot 提供后端接口服务,构建一个用于机器人设备(如扫地机器人、仿生机械狗)状态监控与控制的基础系统。

本搭建过程面向具备一定 Java 和前端基础的开发者,目标是完成:

  • Spring Boot 后端接口开发(用于提供机器人数据与控制指令 API)

  • Vue3 前端页面搭建(展示机器人列表,进行状态控制)

  • Axios 与 Router 等前端模块联调

  • Element Plus 表格与按钮操作集成

整个项目遵循前后端解耦,接口通过 http://localhost:8080 提供服务,前端运行于 http://localhost:5173

以下内容将完整展示后端代码结构与前端页面逻辑,适合作为后续接入 MQTT、WebSocket、地图定位、权限登录等功能的基础框架。


目录

[前言:Vue3 + Spring Boot 前后端分离项目搭建说明](#前言:Vue3 + Spring Boot 前后端分离项目搭建说明)

一、全流程步骤总览

二、详细步骤指南

[步骤1:安装 Node.js 和 npm](#步骤1:安装 Node.js 和 npm)

[步骤2:安装 Vite 并创建 Vue 项目](#步骤2:安装 Vite 并创建 Vue 项目)

[步骤3:用 VS Code 打开项目](#步骤3:用 VS Code 打开项目)

[步骤4:安装 Element Plus 和 Axios](#步骤4:安装 Element Plus 和 Axios)

步骤5:创建并替换页面

可选:设置路由(方便页面跳转)

步骤6:运行项目

常见问题


一、全流程步骤总览

我们使用VSCode 编辑器 + Vue 插件

步骤 操作
1️⃣ 安装 Node.js 和 npm
2️⃣ 安装 Vite(创建 Vue 项目)
3️⃣ 使用 VS Code 打开项目
4️⃣ 安装 Element Plus 和 Axios
5️⃣ 创建 RobotList.vue 页面
6️⃣ 运行项目进行联调

二、详细步骤指南

步骤1:安装 Node.js 和 npm

访问官网下载安装 Node.js(会自动包含 npm):

👉 官网:Node.js --- Run JavaScript Everywhere

建议版本:LTS(长期支持)版本,18 或以上

安装后验证:

bash 复制代码
node -v npm -v

步骤2:安装 Vite 并创建 Vue 项目

打开终端(可在 VS Code 里按 Ctrl+` 打开),运行:

bash 复制代码
npm create vite@latest robot-ui

根据提示选择:

  • ✔ 项目名:robot-ui

  • ✔ 框架:Vue

  • ✔ 变体:JavaScript(或 TypeScript,任选)

然后进入项目并安装依赖:

bash 复制代码
cd robot-ui npm install

步骤3:用 VS Code 打开项目

回到 VS Code:

  • 点左上角菜单 File → Open Folder...

  • 选择刚创建的 robot-ui 文件夹

  • 等待加载完成后,项目结构大概如下:

bash 复制代码
robot-ui/
├─ public/
├─ src/
│  ├─ assets/
│  ├─ App.vue
│  ├─ main.js
├─ index.html
├─ vite.config.js
复制代码

步骤4:安装 Element Plus 和 Axios

在项目根目录下运行:

复制代码
bash 复制代码
npm install element-plus axios

main.js 中添加全局引入:

复制代码
javascript 复制代码
// src/main.js
import { createApp } from 'vue'
import App from './App.vue'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'

createApp(App).use(ElementPlus).mount('#app')

步骤5:创建并替换页面

src/ 下新建目录 views,并在其中添加:

bash 复制代码
src/views/RobotList.vue

然后把你 canvas 中的 RobotList.vue 代码粘贴进去即可(你已经有完整代码)。


可选:设置路由(方便页面跳转)

bash 复制代码
npm install vue-router

然后在 src/router/index.js 添加:

复制代码
javascript 复制代码
import { createRouter, createWebHistory } from 'vue-router'
import RobotList from '../views/RobotList.vue'

const routes = [{ path: '/', component: RobotList }]

export default createRouter({
  history: createWebHistory(),
  routes,
})

并在 main.js 中启用路由:

javascript 复制代码
import router from './router'
createApp(App).use(router).use(ElementPlus).mount('#app')

步骤6:运行项目

bash 复制代码
npm run dev

打开浏览器访问:

(这个是有错误的)

bash 复制代码
http://localhost:5173

如果你的 Spring Boot 后端也已运行,你将看到一个机器人表格页面,并可点击发送控制指令。


常见问题

问题 解决方式
跨域报错 确保后端加了 @CrossOrigin 注解,或配置全局 CORS
接口访问不到 检查后端端口 8080 是否运行成功
页面空白 控制台是否报错,检查 Axios 请求路径拼写和组件挂载是否正确
相关推荐
q***071415 分钟前
Spring Boot 多数据源解决方案:dynamic-datasource-spring-boot-starter 的奥秘(上)
java·spring boot·后端
郝开21 分钟前
Spring Boot 2.7.18(最终 2.x 系列版本)8 - 日志:Log4j2 基本概念;Log4j2 多环境日志配置策略
spring boot·单元测试·log4j
q***498622 分钟前
Spring Boot 3.4 正式发布,结构化日志!
java·spring boot·后端
西洼工作室2 小时前
项目环境变量配置全攻略
前端
阿珊和她的猫2 小时前
Webpack 优化:构建速度与包体积的双重提升
前端·webpack·node.js
阿珊和她的猫2 小时前
Webpack 打包体积优化:让应用更轻量、更高效
前端·webpack·状态模式
im_AMBER2 小时前
Vite + React 项目启动深度踩坑指南
前端·学习·react.js·前端框架
Hammer Ray2 小时前
前端开发基础概念(React)
前端·react.js·前端框架
沐浴露z3 小时前
【微服务】基本概念介绍
java·微服务
Z3r4y3 小时前
【代码审计】RuoYi-4.7.3&4.7.8 定时任务RCE 漏洞分析
java·web安全·ruoyi·代码审计