💜 想真正擅长编程? 从一门课程开始,100% 免费

5-1、环境搭建到项目运行完整复盘

前面4章讲了从环境搭建到项目运行的全过程。这节把整个流程串起来做一个完整复盘,让你清楚知道每一步做了什么、为什么做、有什么要注意的。


一、全局流程图

TEXT
环境搭建(第1章)
  │
  ├─ 1. JDK安装+环境变量
  ├─ 2. Maven安装+阿里云镜像
  ├─ 3. IDEA安装+常用设置
  ├─ 4. MySQL安装+密码+远程
  ├─ 5. Redis安装+配置
  ├─ 6. Git安装+SSH密钥
  └─ 7. 全套环境测试
        │
        ▼
项目拉取+运行(第2章)
  │
  ├─ 1. Git克隆项目+切分支
  ├─ 2. IDEA导入+Maven/JDK配置
  ├─ 3. 修改配置文件
  ├─ 4. 数据库初始化
  ├─ 5. SpringBoot启动
  ├─ 6. Vue前端启动
  └─ 7. 前后端联调
        │
        ▼
报错排查(第3章)
  │
  ├─ 1. Maven依赖爆红
  ├─ 2. 端口被占用
  ├─ 3. 数据库连接失败
  ├─ 4. IDEA找不到类
  ├─ 5. 接口404/500
  ├─ 6. 跨域问题
  ├─ 7. Redis连接失败
  └─ 8. 常见异常汇总
        │
        ▼
职场规范(第4章)
  │
  ├─ 1. Git提交规范
  ├─ 2. 看懂项目架构
  ├─ 3. 问问题姿势
  ├─ 4. IDEA快捷键
  ├─ 5. 开发工具推荐
  └─ 6. 入职规划

二、环境搭建复盘

每一步的核心要点

第1步:JDK

要点 说明
版本 问项目用什么版本,别自己瞎装
路径 无中文无空格
环境变量 JAVA_HOME + Path + CLASSPATH(仅JDK8)
验证 java -version + javac -version

最容易犯的错: Path配了但没开新cmd窗口,以为没生效。

第2步:Maven

要点 说明
本地仓库 不放C盘
阿里云镜像 必配,否则下载慢到崩溃
JDK编译版本 在settings.xml里配
IDEA全局配置 设为全局,新项目自动用

最容易犯的错: IDEA用的自带Maven,没改成自己的。

第3步:IDEA

要点 说明
编码 全部UTF-8
自动导包 开启,省事
自动编译 开启,配合热部署
插件 Lombok、MyBatisX等
内存 增大-Xmx,大项目不卡

最容易犯的错: Lombok没开Annotation Processing。

第4步:MySQL

要点 说明
版本 问项目用什么版本
密码 记住!
远程连接 创建'%'用户 + 防火墙放行
认证方式 老客户端改mysql_native_password
字符集 utf8mb4

最容易犯的错: 用了utf8而不是utf8mb4。

第5步:Redis

要点 说明
安装方式 Windows版/Docker/WSL2
密码 配置文件里设
持久化 appendonly yes
远程连接 bind 0.0.0.0

最容易犯的错: 设了密码但项目配置文件没配password。

第6步:Git

要点 说明
用户名邮箱 用真名和公司邮箱
SSH密钥 生成后绑定到代码平台
.gitignore 排除编译文件和敏感配置
默认分支名 main

最容易犯的错: 公钥没复制完整,少了个ssh-ed25519开头。


三、项目运行复盘

完整步骤

TEXT
1. 克隆代码 → git clone
2. 导入IDEA → File → Open
3. 等Maven下载 → 看进度条
4. 配置JDK → Project Structure → SDK
5. 配置Maven → Settings → Maven
6. 找SQL脚本 → 项目sql目录
7. 建数据库 → CREATE DATABASE utf8mb4
8. 导入SQL → 命令行/图形工具
9. 改配置文件 → 数据库/Redis/端口
10. 启动后端 → 运行启动类
11. 安装Node → 配淘宝镜像
12. 安装前端依赖 → npm install
13. 改API地址 → .env/proxy
14. 启动前端 → npm run dev
15. 浏览器访问 → 看页面
16. 测试接口 → Postman
17. 前后端联调 → F12看请求

每一步的检查点

步骤 检查点 通过标志
克隆代码 代码拉下来了 目录有pom.xml
导入IDEA 依赖加载完成 没有红色报错
配置JDK SDK选对 Project Structure显示正确版本
配置Maven 用自己的Maven settings.xml路径正确
建数据库 数据库存在 SHOW DATABASES能看到
导入SQL 表创建成功 SHOW TABLES能看到
改配置 密码地址正确 配置文件无标红
启动后端 Tomcat启动 "Started in x seconds"
启动前端 页面显示 浏览器能看到页面
联调 接口返回数据 Network无报错

四、报错排查复盘

按场景分类的排查流程

场景1:项目启动不了

TEXT
项目启动报错
  │
  ├─ 端口被占? → netstat -ano查 → 杀进程或换端口
  │
  ├─ 数据库连不上? → 服务启动了吗 → 密码对吗 → 端口通吗
  │
  ├─ Redis连不上? → 服务启动了吗 → 密码对吗 → bind配了吗
  │
  ├─ 依赖找不到? → 刷新Maven → 删.lastUpdated → 检查镜像
  │
  ├─ Bean创建失败? → 看Caused by → 检查注解和注入
  │
  └─ Nacos连不上? → 本地装Nacos或改配置

场景2:接口报错

TEXT
接口返回错误
  │
  ├─ 404? → 路径对吗 → context-path加了吗 → 方法匹配吗
  │
  ├─ 500? → 看日志堆栈 → 找Caused by → 打断点调试
  │
  ├─ 401? → Token带了吗 → Token过期了吗
  │
  ├─ 403? → 有权限吗 → 拦截器拦了吗
  │
  ├─ 400? → 参数对吗 → 格式对吗 → 字段名匹配吗
  │
  └─ 跨域? → 前端Proxy → 后端CORS → OPTIONS放行

场景3:代码标红

TEXT
IDEA代码标红
  │
  ├─ 第三方类找不到? → 刷新Maven → mvn clean install
  │
  ├─ 项目内部类找不到? → 多模块没install → 重建索引
  │
  ├─ Lombok不生效? → 装插件 → 开Annotation Processing
  │
  ├─ JDK版本不对? → 换JDK → 改Language Level
  │
  └─ 源码目录没标记? → Project Structure标记Sources

五、环境搭建时间估算

如果你按这套教程一步步来,时间大概是这样:

步骤 预计时间 说明
JDK安装 15分钟 下载+安装+配环境变量
Maven安装 15分钟 下载+解压+配镜像
IDEA安装 20分钟 安装+配置+装插件
MySQL安装 30分钟 安装+配置+建库
Redis安装 15分钟 安装+配置
Git安装 20分钟 安装+配置+SSH密钥
环境测试 30分钟 写测试项目验证
小计 2.5小时
拉代码+导入 30分钟 clone+IDEA导入+等Maven
改配置 20分钟 改数据库/Redis/端口
初始化数据库 15分钟 建库+导SQL
启动后端 30分钟 启动+排错
启动前端 30分钟 npm install+启动
联调 30分钟 调通前后端
小计 2.5小时

顺利的话半天(5小时)搞定全套环境+项目运行。

如果不顺利(遇到各种报错),可能需要1-2天。 别急,按第3章的排查方法一步步来。


六、常见环境问题汇总

按出现频率排序

排名 问题 出现频率 解决方法
1 Maven依赖爆红 ⭐⭐⭐⭐⭐ 刷新+删.lastUpdated+检查镜像
2 端口被占用 ⭐⭐⭐⭐⭐ 杀进程或换端口
3 数据库连不上 ⭐⭐⭐⭐ 查服务+密码+URL参数
4 Redis连不上 ⭐⭐⭐⭐ 查服务+密码+bind
5 跨域报错 ⭐⭐⭐ 前端Proxy或后端CORS
6 IDEA找不到类 ⭐⭐⭐ 刷新Maven+重建索引
7 接口404 ⭐⭐⭐ 对比路径+context-path
8 Lombok不生效 ⭐⭐ 装插件+开Annotation Processing
9 中文乱码 ⭐⭐ 统一UTF-8
10 npm install失败 ⭐⭐ 换淘宝镜像+删node_modules重装

七、环境备份建议

环境搭好以后,建议备份以下内容:

1. 配置文件备份

文件 位置 用途
settings.xml Maven配置目录 镜像+仓库+编译版本
.gitconfig ~/.gitconfig Git用户名+邮箱
SSH密钥 ~/.ssh/ 免密推拉代码
IDEA配置导出 File → Export Settings 所有IDEA设置

2. 软件安装包备份

把所有安装包存在一个目录:

TEXT
D:\installers\
  jdk-8u371-windows-x64.exe
  apache-maven-3.9.6-bin.zip
  ideaIU-2023.3.exe
  mysql-installer-community-8.0.36.msi
  Redis-x64-5.0.14.zip
  Git-2.43.0-64-bit.exe
  node-v18.19.0-x64.msi

换电脑时直接用这些安装包,不用重新下载。

3. 环境清单备份

把你的环境信息记录下来:

TEXT
JDK版本:1.8.0_371
Maven版本:3.9.6
IDEA版本:2023.3
MySQL版本:8.0.36
Redis版本:5.0.14
Git版本:2.43.0
Node版本:18.19.0

JAVA_HOME:D:\Java\jdk1.8.0_371
MAVEN_HOME:D:\Java\apache-maven-3.9.6
本地仓库:D:\Java\maven-repository
MySQL密码:Root@123456
Redis密码:Redis@123456

存一份在手机备忘录或云笔记里,换电脑时照着装。


八、完整流程检查清单

把下面这个清单打印出来或存手机里,每次搭环境逐项打勾:

环境搭建

  • JDK安装完成,java -version正常
  • Maven安装完成,mvn -version正常
  • Maven本地仓库路径已修改
  • Maven阿里云镜像已配置
  • IDEA安装完成
  • IDEA编码设为UTF-8
  • IDEA自动导包已开启
  • IDEA自动编译已开启
  • IDEA Maven配置正确
  • IDEA Lombok插件已安装
  • IDEA Annotation Processing已开启
  • MySQL安装完成,能正常连接
  • MySQL字符集为utf8mb4
  • Redis安装完成,ping返回PONG
  • Git安装完成,git --version正常
  • Git用户名邮箱已配置
  • SSH密钥已生成
  • SSH公钥已添加到代码平台

项目运行

  • 代码已克隆到本地
  • 项目已导入IDEA
  • Maven依赖无报错
  • JDK版本配置正确
  • 数据库已创建
  • SQL脚本已导入
  • 配置文件已修改(数据库/Redis/端口)
  • SpringBoot后端启动成功
  • 接口能正常访问
  • Node.js已安装
  • npm镜像已配置
  • 前端依赖已安装
  • 前端项目启动成功
  • 前端页面能正常显示
  • 前后端联调正常
  • 无跨域报错

小结

从环境搭建到项目运行,完整流程总结:

TEXT
装环境(7步)→ 拉代码(1步)→ 改配置(1步)→ 建数据库(1步)
→ 启动后端(1步)→ 启动前端(1步)→ 联调(1步)

13步,走完这13步,你就能在公司项目上写代码了。

遇到任何问题,翻第3章对应的小节,99%的问题都有解决方案。