必须使用jdk 17+和maven 3.8.6+:先通过adoptium下载temurin 17 arm64/x64版,配置~/.zshrc中java_home及path,再用homebrew或手动安装maven并设阿里云镜像;最后在idea 2023.3+中关联jdk与maven,创建项目时手动选spring boot 4.0.0+版本。

在Mac上为Spring Boot 4.0项目配置开发环境,必须使用JDK 17或更高版本(Spring Boot 4.0官方要求JDK 17+),且Maven需为3.8.6及以上;若沿用旧版JDK 8或Maven 3.6,项目创建时会直接失败或依赖解析中断。
安装并配置JDK 17+
访问Adoptium官网(https://adoptium.net)下载Temurin 17 LTS macOS ARM64或x64 .pkg安装包,双击运行完成安装。
终端执行:/usr/libexec/java_home -V,确认输出中包含类似 17.0.1 的条目;若无,请重装或检查是否选错架构版本。
编辑 shell 配置文件:根据你的终端类型(zsh为默认),运行 vim ~/.zshrc(不是.bash_profile,macOS Catalina后默认已切换)。
插入以下三行(注意路径需与java_home -V输出一致):export JAVA_HOME=$(/usr/libexec/java_home -v 17)export PATH=$JAVA_HOME/bin:$PATHexport CLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar:.
【务必保存后执行 source ~/.zshrc,否则后续所有命令都看不到新JDK】
验证:输入 java -version,输出应为 openjdk version "17.0.1" 或更高,且无“command not found”提示。
安装Maven并配置国内镜像
推荐使用Homebrew一键安装:终端运行 brew install maven。该方式自动适配Apple Silicon和Intel芯片,无需手动解压、移动路径。
若已手动下载Apache Maven压缩包,请解压至/opt/apache-maven-3.9.7(路径不含空格、不带中文),然后在~/.zshrc末尾追加:export MAVEN_HOME=/opt/apache-maven-3.9.7export PATH=$MAVEN_HOME/bin:$PATH
执行 source ~/.zshrc 后,运行 mvn -v 应显示Maven版本及Java版本——此处Java版本必须与上一步的JDK 17一致,否则IDEA无法识别有效Maven运行时。
配置阿里云镜像:打开 /opt/homebrew/Cellar/maven/3.9.7/libexec/conf/settings.xml(Homebrew安装路径)或 $MAVEN_HOME/conf/settings.xml(手动安装路径),在<mirrors></mirrors>标签内插入:
<mirror></mirror><id>aliyunmaven</id><mirrorof>*</mirrorof><name>Aliyun Maven</name><url>https://maven.aliyun.com/repository/public</url>
在IntelliJ IDEA中启用Spring Boot 4.0支持
确保IDEA版本 ≥ 2023.3(低于此版本不识别Spring Boot 4.x的starter坐标和parent POM)。前往JetBrains官网下载最新Ultimate或Community版,安装后启动。
第一步:打开 Preferences → Build, Execution, Deployment → Build Tools → Maven。
第二步:在Maven home path中选择你安装的Maven路径(如/opt/homebrew/Cellar/maven/3.9.7/libexec);
第三步:确认User settings file指向刚修改过的settings.xml,Local repository可保持默认或指定为~/m2/repository。
进入 Preferences → Languages & Frameworks → Java → SDKs,点击+ → Add JDK → 选择/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home(路径以java_home -V实际输出为准)。
新建项目时,选择 File → New → Project → Spring Initializr,务必将Spring Boot版本下拉框手动设为4.0.0或更高(如4.0.4);若列表中无4.x选项,说明JDK或IDEA版本不达标,需退回前两步排查。
勾选Spring Web和Lombok(可选),点击Create。等待依赖下载完成(首次可能耗时2–5分钟),观察右下角Maven工具窗口是否显示Dependencies resolved且无红色报错。











