RuoYi-Vue-master：Spring Boot 4.x (JDK 17+) （环境搭建）

RuoYi-Vue master 分支 全环境稳定版本 官方下载地址下面是你全新项目开发的全链路稳定版本组合每个组件都附了官方直达下载地址直接点就能下零踩坑提示环境配置教程在最下面一、后端核心环境必装1. JDK 17 LTSSpring Boot 4.x 强制要求发行版推荐版本官方下载地址选型说明Eclipse Temurin (Adoptium) OpenJDK 17企业首选免费无授权17.0.10 LTShttps://adoptium.net/zh-CN/temurin/releases/?version17[1]开源免费、全平台支持、社区最稳定生产环境首选Oracle JDK 17 LTS17.0.10 LTShttps://www.oracle.com/java/technologies/downloads/#java17[2]官方原版需注册Oracle账号注意商业授权Amazon Corretto 1717.0.10 LTShttps://docs.aws.amazon.com/corretto/latest/corretto-17-ug/downloads-list.html[3]亚马逊开源发行版免费稳定适合云环境✅ 安装提示Windows选.msi自动配置环境变量Linux选.tar.gz手动解压Mac选对应芯片架构。2. Apache Maven项目构建工具推荐版本官方下载地址选型说明3.8.8长期稳定版https://maven.apache.org/download.cgi[4] 页面选3.8.8社区沉淀最久无兼容性问题适合老项目/保守选型3.9.6最新稳定版https://maven.apache.org/download.cgi[5] 页面选3.9.6性能优化更好适合新项目完全兼容Spring Boot 4.x✅ 安装提示Windows下载apache-maven-xxx-bin.zipLinux/Mac下载-bin.tar.gz不要下source源码包。3. MySQL数据库推荐版本官方下载地址选型说明MySQL 8.0.36推荐主流稳定版https://dev.mysql.com/downloads/mysql/[6] 选8.0.x / https://downloads.mysql.com/archives/community/[7]支持最新特性、性能更优新项目首选MySQL 5.7.44兼容老系统https://downloads.mysql.com/archives/community/[8] 选5.7.44仅用于需要兼容老系统的场景8.0是未来趋势✅ 安装提示Windows用MySQL Installer一键安装配置Linux用tar.gz源码包或yum/apt安装。4. Redis缓存中间件推荐版本官方下载地址选型说明Redis 6.2.14LTS长期支持版https://download.redis.io/releases/redis-6.2.14.tar.gz[9] / https://redis.io/download/[10]稳定性拉满生产环境首选无新特性风险Redis 7.2.4最新稳定版https://download.redis.io/releases/redis-7.2.4.tar.gz[11] / https://redis.io/download/[12]性能更强适合追求新特性的场景✅ 安装提示Linux直接用wget下载源码编译Windows用微软维护的发行版https://github.com/microsoftarchive/redis/releases。[13]二、前端核心环境必装1. Node.js前端运行环境推荐版本官方下载地址选型说明Node.js 18.19.1 LTSHydrogen推荐https://nodejs.org/en/download/archive/v18.19.1/[14] / https://nodejs.cn/download/[15]Vue 2/3生态最兼容无高版本依赖冲突开发/生产都稳Node.js 20.12.2 LTSIronhttps://nodejs.org/en/blog/release/v20.12.2/[16] / https://nodejs.org/[17]最新LTS性能更好适合新项目✅ 安装提示Windows选.msi自动配置环境变量自带npm 9.6.7无需额外安装npm。2. 包管理器pnpm 可选npm 随Node自带工具推荐版本安装方式说明npm9.6.7随Node 18自带无需额外下载官方原生若依项目默认支持零配置pnpm 8.15.5推荐提速8.15.5安装命令npm install -g pnpm8.15.5比npm快3-5倍节省磁盘空间适合前端开发✅ 安装提示pnpm无需单独下载安装包Node安装后直接用npm全局安装即可。三、生产环境辅助工具推荐1. Nginx反向代理/前端部署推荐版本官方下载地址选型说明Nginx 1.26.1稳定版https://nginx.org/download/nginx-1.26.1.tar.gz[18] / https://nginx.org/en/download.html[19]最新稳定版性能和稳定性平衡生产首选Nginx 1.25.5主线版https://nginx.org/download/nginx-1.25.5.tar.gz[20]包含新特性适合测试环境不推荐生产✅ 安装提示Windows下载nginx-xxx.zip直接解压运行Linux用源码编译或yum/apt安装。四、开发工具可选推荐工具推荐版本官方下载地址用途IntelliJ IDEA2024.1https://www.jetbrains.com/idea/download/[21]后端Java/Spring Boot开发对JDK 17、Spring Boot 4.x支持最佳VS Code1.88https://code.visualstudio.com/download[22]前端Vue开发轻量高效Docker容器化部署25.0.3https://www.docker.com/get-started/[23]一键部署项目环境避免环境差异 快速安装验证命令一键检查环境后端环境验证# 验证JDKjava -version# 验证Mavenmvn -v# 验证MySQLmysql --version# 验证Redisredis-server --version前端环境验证# 验证Node.js/npmnode -vnpm -v# 验证pnpm如果安装pnpm -v⚠️ 避坑红线绝对不要踩1.JDK 17是唯一选择master分支基于Spring Boot 4.x不支持JDK 8/11强行使用会直接启动失败2.全链路LTS优先所有组件优先选「长期支持版LTS」避免非LTS版本如JDK 18/19、Node 19/21的兼容性问题3.环境一致性开发、测试、生产环境必须使用完全相同的版本杜绝「本地能跑、线上报错」的版本差异问题4.不要用cnpm前端依赖安装严禁用cnpm会出现依赖缺失、版本错乱用npm/pnpm原生安装。需要我给你一份从0到1的环境安装项目启动保姆级步骤吗包含每个工具的环境变量配置、Maven阿里云镜像配置、MySQL初始化脚本直接照着做就能跑通项目。Maven环境适配3.9.6 官方下载入口 直链1. 官方历史版本归档页推荐入口访问 Maven 官方历史版本库https://archive.apache.org/dist/maven/maven-3/找到3.9.6文件夹 → 进入binaries目录即可下载对应包Windows 用apache-maven-3.9.6-bin.zipLinux/Mac 用apache-maven-3.9.6-bin.tar.gz2. 直接下载直链复制到浏览器即可下载Windows 二进制 zip 包https://dlcdn.apache.org/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.zipLinux/Mac 二进制 tar.gz 包https://dlcdn.apache.org/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gz一、先选对下载包别下错你当前页面只有源码包src开头不能用必须下载二进制包bin开头步骤如下1. 回到正确目录点击页面最上方的Parent Directory父目录回到3.9.6根目录再进入binaries文件夹就能看到正确的二进制包•✅Windows系统下载apache-maven-3.9.6-bin.zip•✅Linux/Mac系统下载apache-maven-3.9.6-bin.tar.gz 绝对不要下载src开头的包源码包需要自己编译普通开发用不上二、Maven 核心配置settings.xml 模板直接用解压 Maven 后找到conf/settings.xml文件用下面的完整配置替换一键解决国内下载慢、依赖拉不到的问题完全适配 RuoYi-Vue 项目?xml version1.0 encodingUTF-8? settings xmlnshttp://maven.apache.org/SETTINGS/1.2.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/SETTINGS/1.2.0 http://maven.apache.org/xsd/settings-1.2.0.xsd !-- 本地仓库路径改成你自己的目录建议非系统盘 -- localRepositoryD:\maven\repository/localRepository !-- 全局镜像阿里云国内首选100%覆盖中央仓库 -- mirrors mirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror mirror idaliyunmaven-spring/id mirrorOfspring/mirrorOf name阿里云Spring仓库/name urlhttps://maven.aliyun.com/repository/spring/url /mirror /mirrors !-- JDK 17 编译配置适配RuoYi-Vue master/springboot3分支 -- profiles profile idjdk-17/id activation activeByDefaulttrue/activeByDefault jdk17/jdk /activation properties maven.compiler.source17/maven.compiler.source maven.compiler.target17/maven.compiler.target maven.compiler.compilerVersion17/maven.compiler.compilerVersion maven.compiler.encodingUTF-8/maven.compiler.encoding project.build.sourceEncodingUTF-8/project.build.sourceEncoding /properties /profile !-- 若用springboot2分支/JDK8用这个profile替换上面的jdk-17 -- !-- profile idjdk-8/id activation activeByDefaulttrue/activeByDefault jdk1.8/jdk /activation properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target maven.compiler.compilerVersion1.8/maven.compiler.compilerVersion maven.compiler.encodingUTF-8/maven.compiler.encoding project.build.sourceEncodingUTF-8/project.build.sourceEncoding /properties /profile -- /profiles !-- 全局激活jdk-17 profile -- activeProfiles activeProfilejdk-17/activeProfile /activeProfiles /settings三、关键配置说明按需修改1.本地仓库路径•把localRepositoryD:\maven\repository/localRepository改成你自己的目录比如D:\dev\maven-repo不要放在C盘避免系统盘爆满。2.JDK版本适配•用master/springboot3 分支JDK17保留jdk-17配置注释jdk-8•用springboot2 分支JDK8注释jdk-17启用jdk-8配置3.镜像说明•阿里云公共仓库完全替代 Maven 中央仓库国内下载速度提升10倍以上RuoYi-Vue 所有依赖都能正常拉取。四、环境变量配置Windows 示例1.新建系统变量MAVEN_HOME值为 Maven 解压目录比如D:\dev\apache-maven-3.9.62.编辑系统变量Path新增%MAVEN_HOME%\bin3.验证打开CMD执行mvn -v能看到版本号即配置成功五、避坑提醒•下载包必须是bin开头src开头的源码包无法直接使用•配置文件必须放在conf/settings.xml不要放错位置•本地仓库目录不要有中文、空格避免路径错误•配置完成后第一次执行mvn clean install会自动下载依赖到本地仓库耐心等待即可需要我给你一份从解压到环境变量配置、再到项目启动的完整步骤吗直接照着做就能跑通 RuoYi-Vue。MySQL 8.0.30 winx64.zip 安装教程我给你最简单、最稳妥、一步不踩坑的MySQL 8.0.30winx64.zip解压版安装教程全程照着做就能用MySQL 8.0.30 winx64.zip 安装教程纯手动版一、准备工作1.把你下载的mysql-8.0.30-winx64.zip解压 推荐路径D:\mysql-8.0.30-winx64✅ 路径不要有中文、空格2.在解压目录里新建两个东西•新建文件夹data空文件夹•新建文件my.ini配置文件二、编辑 my.ini 配置文件把下面内容直接复制进去只需要改路径[mysqld] # 设置3306端口 port3306 # 设置mysql的安装目录改成你自己的解压路径 basedirD:\\mysql-8.0.30-winx64 # 设置mysql数据库的数据的存放目录 datadirD:\\mysql-8.0.30-winx64\\data # 允许最大连接数 max_connections200 # 允许连接失败的次数 max_connect_errors10 # 服务端使用的字符集默认为UTF8MB4 character-set-serverutf8mb4 # 创建新表时将使用的默认存储引擎 default-storage-engineINNODB # 默认使用“mysql_native_password”插件认证 default_authentication_pluginmysql_native_password [mysql] # 设置mysql客户端默认字符集 default-character-setutf8mb4 [client] # 设置mysql客户端连接服务端时默认使用的端口 port3306 default-character-setutf8mb4注意•路径必须用\\双反斜杠•basedir 和 datadir 必须是你真实的路径三、初始化 MySQL关键步骤1.以管理员身份打开 cmd2.进入 MySQL 的 bin 目录cd D:\mysql-8.0.30-winx64\bin3.执行初始化命令会生成临时密码mysqld --initialize --console执行完后你会看到一行A temporary password is generated for rootlocalhost: ********✅把这个密码记下来后面必须用四、安装 MySQL 服务mysqld --install mysql8出现Service successfully installed.就成功了五、启动服务net start mysql8六、登录并修改密码非常重要mysql -uroot -p粘贴刚才的临时密码登录登录成功后执行ALTER USER rootlocalhost IDENTIFIED BY 123456;密码改成你自己的比如123456然后刷新权限FLUSH PRIVILEGES;七、配置环境变量让任何地方都能用 mysql 命令1.右键此电脑 → 属性 → 高级系统设置 → 环境变量2.系统变量 → 新建•变量名MYSQL_HOME•变量值D:\mysql-8.0.30-winx643.找到 Path → 编辑 → 新建%MYSQL_HOME%\bin安装完成测试一下关闭 cmd重新打开普通 cmdmysql -uroot -p123456能直接进入 MySQL 就说明完全装好了总结1.解压 → 新建 data my.ini2.初始化 → 得到临时密码3.安装服务 → 启动服务4.登录 → 修改密码5.配置环境变量你跟着我这一套做100%能装好。 需要我一步步带你截图式讲解吗或者你现在做到哪一步了我直接帮你看