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 请求路径拼写和组件挂载是否正确
相关推荐
宠友信息3 分钟前
内容社区源码开发实践解析,用Spring Boot打造1:1仿小红书源码平台
java·spring boot·redis·websocket·mysql·spring·uni-app
马可家的菠萝4 分钟前
自动保存已经有了,为什么笔记软件还需要“历史版本”?
前端·后端·架构
leavesleo7 分钟前
AI Agent 开发实战:从零搭一个能用的 Agent
后端
行百里er15 分钟前
加个依赖就生效?一行搞定 Spring Boot Starter 自动装配
java·后端·监控
半个落月19 分钟前
从 "use client" 到 Route Handler:用 Todos 理解 Next.js 水合与全栈请求
前端·react.js·next.js
月华路22 分钟前
G1 新生代对象晋升老年代:实现机制与 GC 日志
java·jvm·算法
qq_4523962322 分钟前
第七篇:《大型前端项目的模块化与目录结构设计》
前端
Su米苏31 分钟前
Redis高级用法
spring boot·redis
你脑门上的脚印31 分钟前
Vue 项目从零实现语音转文字、文字转语音功能(完整可用 + 踩坑指南)
前端·vue.js