一次完整的Java开发环境配置实战记录

发布时间：2026-01-22 01:20:25 阅读：194 次

刚接手一个新项目，团队要求统一使用Java 17 + Spring Boot 3 + Maven构建，本地跑不起来就成了我第一天的“拦路虎”。报错信息五花八门：版本不兼容、依赖下载失败、JDK路径识别错误……折腾半天才意识到，开发环境配置不是点几下安装就行，得一步步来。

JDK 安装与切换

Mac 上同时装了 Java 8 和 Java 17，终端默认还是用的旧版。查了一下，可以用 brew 装 OpenJDK：

brew install openjdk@17

安装完需要手动链接到系统路径：

sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk

然后在 ~/.zshrc 里指定 JAVA_HOME：

export JAVA_HOME=/opt/homebrew/opt/openjdk@17

重新 source 一下配置，输入 java -version 终于看到输出是 17 了。

Maven 配置国内镜像

直接用官方源拉依赖太慢，动不动超时。改 ~/.m2/settings.xml，加上阿里云镜像：

<mirrors>
  <mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
  </mirror>
</mirrors>

这一改，原本半小时下不完的包，几秒就搞定了。

IDEA 中项目识别问题

虽然命令行能编译，但 IDEA 打开项目还是提示 “Project SDK not defined”。进 Settings → Project → Project SDK，手动选中 JDK 17，再把 Language level 调到 17。Maven 的 home directory 也改成自己安装的那个版本，避免用内置的。

环境变量与脚本自动化

每次换机器都重来一遍太麻烦。后来写了个简单的 shell 脚本，把 JDK、Maven、Git 用户名邮箱全设好，新同事入职直接运行，十分钟搞定基础环境。