返回

轻松掌握 RuoYi-Vue 前后端启动流程,开启开发之旅

前端

RuoYi-Vue 开发指南:搭建环境、启动项目和常见问题解答

搭建开发环境

踏上 RuoYi-Vue 开发之旅的第一步,需要搭建一个完善的开发环境。要开始这个过程,请按照以下步骤操作:

  1. 安装 Node.js 和 npm: Node.js 是 JavaScript 运行时,而 npm 是一个包管理器,用于管理 Node.js 模块。
  2. 安装 Git: Git 是一个版本控制系统,用于管理代码更改。
  3. 安装 Java JDK: Java JDK(Java 开发工具包)是开发 Java 应用程序的必备工具。
  4. 安装 Maven: Maven 是一个构建自动化工具,用于管理 Java 项目的依赖项和构建过程。
  5. 安装 IntelliJ IDEA 或其他代码编辑器: 选择一个趁手的代码编辑器,如 IntelliJ IDEA,以方便代码编写和调试。

获取 RuoYi-Vue 代码

现在开发环境已经准备就绪,是时候获取 RuoYi-Vue 代码库了:

  1. 克隆 RuoYi-Vue 代码库: 使用 Git 从 RuoYi-Vue 代码仓库克隆一份本地副本。
  2. 安装依赖项: 进入克隆后的代码目录,运行 mvn install 命令安装项目依赖项。

配置数据库

接下来,需要配置数据库以存储 RuoYi-Vue 项目的数据:

  1. 修改 application.yml 配置: 编辑 application.yml 文件,根据数据库类型(例如 MySQL、PostgreSQL 等)更新数据库配置。
  2. 执行数据库迁移: 运行 mvn flyway:migrate 命令执行数据库迁移,创建或更新数据库架构。

启动 RuoYi-Vue 项目

环境配置完毕后,就可以启动 RuoYi-Vue 项目了:

  1. 启动后端服务: 在项目根目录执行 mvn spring-boot:run 命令。
  2. 访问项目首页: 在浏览器中访问 http://localhost:8080/ 查看项目首页。

使用代码生成器

RuoYi-Vue 提供了一个代码生成器,可以自动生成 CRUD(创建、读取、更新、删除)相关代码:

  1. 启动代码生成器: 进入 ruoyi-vue-generator 模块,执行 mvn spring-boot:run 命令。
  2. 访问生成器页面: 在浏览器中访问 http://localhost:8888/ 查看代码生成器页面。
  3. 配置生成器: 填写生成器表单,配置表名、包名等信息,然后点击“生成”按钮。

代码调试

使用 IntelliJ IDEA 或其他代码编辑器,可以方便地调试 RuoYi-Vue 代码:

  1. 打开项目: 在 IntelliJ IDEA 中打开 RuoYi-Vue 项目。
  2. 设置断点: 在代码中设置断点,以便在特定行停止执行。
  3. 启动调试: 启动调试会话,步过或步入代码,观察变量值的变化。

前后端联调

最后一步是将 RuoYi-Vue 项目的前端和后端连接起来:

  1. 修改前端配置: 编辑 config/dev.env.js 文件,将 VUE_APP_BASE_API 配置为指向后端服务 API 的 URL。
  2. 启动前端项目: 执行 npm run serve 命令启动前端项目。
  3. 访问联调页面: 在浏览器中访问 http://localhost:9528/ 查看前后端联调效果。

常见问题解答

在 RuoYi-Vue 开发过程中可能会遇到一些问题,以下是一些常见的错误及其解决方法:

  1. 项目启动失败怎么办?

    • 检查数据库配置是否正确。
    • 确保已安装 Java JDK 和 Maven。
    • 尝试重新运行 mvn install 命令。
  2. 代码生成器无法生成代码怎么办?

    • 检查数据库连接是否正常。
    • 确保已安装 MySQL 数据库。
    • 尝试重新运行 mvn flyway:migrate 命令。
  3. 前后端联调失败怎么办?

    • 检查 config/dev.env.js 文件中的 VUE_APP_BASE_API 配置是否正确。
    • 确保已启动 RuoYi-Vue 项目的后端服务。
    • 尝试重新运行 npm run serve 命令。
  4. 其他问题怎么办?

    • 查看 RuoYi-Vue 官方文档或社区论坛以寻求帮助。
    • 在 GitHub 上提交问题或 Pull Request 以报告错误或提出改进建议。