前面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%的问题都有解决方案。