【001】Java开发环境

---

前言

git下载一个java项目后，java小白怎么跑起来？ 下面按最小可行步骤来，先能跑起来，再优化开发体验

0) 环境准备

• JDK: 17 或 11（二选一，优先跟项目 pom.xml 要求一致）
• Maven: 3.8+（IDEA 内置也可）
• MySQL、Redis 已安装可用
• IDEA: 已装好

1) 用 IDEA 打开项目

• File > Open 选择仓库根目录。
• 右下角出现 “Import Maven Project” 点 Enable。
• 设置 JDK：File > Project Structure > Project SDK 选择你的 JDK。

2) 必备配置

• 打开 zkmall-*-starter 模块里的 application-*.yml（或 application-*.properties）
  • 配好 MySQL：url/username/password
  • 配好 Redis：host/port/password（若有）
  • 其他三方配置按 README 或注释补齐
• IDEA 开启注解处理：Settings > Build… > Annotation Processors 勾选 Enable（支持 Lombok）
• 若用到本地 profile，复制 application-local.yml 或 application-dev.yml 并改你的连接信息

3) 一键构建

• 命令行（项目根）：
  • Windows: mvn -T 1C -DskipTests clean package
  • 或 IDEA Maven 面板点击根 clean -> package
• 首次构建慢属正常（依赖下载）

4) 运行服务

• 先启动依赖中台/网关/公共模块对应的 *-starter（Maven/Run 面板里 Spring Boot 启动项）
  • 常见顺序：zkmall-commons（若有启动项）→ zkmall-business-starter → zkmall-admin-starter → zkmall-app-starter
  • 还有 zkmall-xxl-job 如需定时任务再启动
• 浏览器/接口工具访问对应端口验证

5) 推荐安装的 IDEA 插件（Java + 常见栈）

• Lombok（必须）
• Maven Helper（看依赖冲突）
• MyBatisX（若项目使用 MyBatis）
• Free MyBatis Plugin 或 MyBatis Log Plugin（可选）
• .ignore（管理 .gitignore）
• Key Promoter X（熟悉快捷键，可选）

6) 常见问题排查

• 构建失败：检查 JDK 版本与 pom 的 maven-compiler-plugin 对齐；删除本地仓库缓存后重试
• 启动连不上库：确认 application-*.yml 的库名、账号、端口、时区参数
• 实体/日志报错：确认 Redis/MySQL 正常启动、密码一致
• 端口占用：换端口或关闭占用进程

需要我帮你快速确认该仓库用的 JDK 版本和可启动的 starter 类名吗？我可以帮你定位并给出具体 Run 配置。