Windows系统运行RuoYi-Vue完整指南

一、环境准备

1. 安装必要软件

• JDK 1.8 或更高版本：确保配置了 JAVA_HOME 环境变量
  • 验证：java -version
• Maven 3.6 或更高版本：确保配置了 MAVEN_HOME 环境变量
  • 验证：mvn -version
• Node.js 14 或更高版本：包含 npm
  • 验证：node -v 和 npm -v
• MySQL 5.7 或更高版本：用于存储数据

2. 数据库配置

1. 创建数据库：

   • 打开 MySQL 命令行或工具（如 Navicat）
   • 执行命令：CREATE DATABASE ruoyi CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

2. 导入初始化脚本：

   • 找到项目中的 SQL 脚本文件（通常在 ruoyi-admin/src/main/resources/sql 目录）
   • 执行脚本：source 路径/ruoyi.sql;（或通过图形界面导入）

二、后端配置与启动

1. 修改数据库连接配置

• 打开文件：ruoyi-admin/src/main/resources/application-druid.yml
• 修改数据库连接信息：

  spring:
    datasource:
      druid:
        # 数据库连接信息
        url: jdbc:mysql://localhost:3306/ruoyi?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
        username: root  # 你的MySQL用户名
        password: 123456  # 你的MySQL密码
  

2. 构建后端项目

• 打开命令行，进入项目根目录：

  cd e:\06研发中心\GIT\RuoYi\RuoYi-Vue-master
  

• 执行 Maven 构建命令：

  mvn clean install
  

3. 启动后端服务

• 方法一：通过 IDE 启动

  • 在 IDE（如 IntelliJ IDEA 或 Eclipse）中打开项目
  • 运行 ruoyi-admin/src/main/java/com/ruoyi/RuoYiApplication.java 类

• 方法二：通过命令行启动

  cd ruoyi-admin
  mvn spring-boot:run
  

• 验证：访问 http://localhost:8080，看到登录页面表示后端启动成功

三、前端配置与启动

1. 安装前端依赖

• 打开命令行，进入前端目录：

  cd e:\06研发中心\GIT\RuoYi\RuoYi-Vue-master\ruoyi-ui
  

• 执行 npm 安装命令：

  npm install
  

2. 启动前端服务

• 执行启动命令：

  npm run dev
  

• 验证：访问 http://localhost:80（或终端显示的地址），看到登录页面表示前端启动成功

四、登录系统

• 默认账号：admin
• 默认密码：admin123

五、常见问题及解决方案

1. 数据库连接失败

• 检查 MySQL 服务是否启动
• 验证数据库用户名和密码是否正确
• 确认数据库 ruoyi 是否已创建并导入脚本

2. 端口冲突

• 后端默认端口：8080
• 前端默认端口：80
• 若端口被占用，可修改配置文件：
  • 后端：修改 application.yml 中的 server.port
  • 前端：修改 ruoyi-ui/.env.development 中的 VUE_APP_BASE_API

3. 前端依赖安装失败

• 尝试使用 npm install --registry=https://registry.npm.taobao.org 加速安装
• 检查网络连接是否正常

4. 启动时出现内存不足

• 调整 JVM 内存参数，在启动命令中添加：

  -Xms512m -Xmx1024m
  

六、项目部署（可选）

1. 后端部署

• 执行打包命令：

  mvn clean package -DskipTests
  

• 部署 ruoyi-admin/target/ruoyi-admin.jar 到服务器

2. 前端部署

• 执行构建命令：

  npm run build:prod
  

• 将 ruoyi-ui/dist 目录部署到 Nginx 或其他静态资源服务器

总结

按照以上步骤操作，即可在 Windows 系统上完整运行 RuoYi-Vue 系统。系统启动后，可通过前端界面进行功能操作，后端提供 API 支持。若遇到问题，可根据错误信息进行排查，或参考项目文档和社区资源。