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 请求路径拼写和组件挂载是否正确
相关推荐
sg_knight1 小时前
Spring Cloud LoadBalancer深度解析:官方负载均衡方案迁移指南与避坑实践
java·spring boot·spring·spring cloud·微服务·负载均衡
llwszx1 小时前
Spring Boot 整合 Spring AI 与 MCP 开发智能体工具指南
人工智能·spring boot·spring·智能体·spring ai·mcp
_何同学2 小时前
Ollama 安装 DeepSeek 与 Spring Boot 集成指南
java·spring boot·后端·ai
知否技术2 小时前
知道这10个npm工具包,开发效率提高好几倍!第2个大家都用过!
前端·npm
希希不嘻嘻~傻希希3 小时前
css基础笔记简洁版1
css
希希不嘻嘻~傻希希3 小时前
CSS 字体与文本样式笔记
开发语言·前端·javascript·css·ecmascript
Code季风3 小时前
跨语言RPC:使用Java客户端调用Go服务端的HTTP-RPC服务
java·网络协议·http·rpc·golang
盖世英雄酱581363 小时前
时间设置的是23点59分59秒,数据库却存的是第二天00:00:00
java·数据库·后端
石小石Orz3 小时前
分享10个吊炸天的油猴脚本,2025最新!
前端
爷_4 小时前
Nest.js 最佳实践:异步上下文(Context)实现自动填充
前端·javascript·后端