必须使用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>标签内插入：
<mirror><id>aliyunmaven</id><mirrorOf>*<name>Aliyun Maven</name><url>https://maven.aliyun.com/repository/public</url></mirror>
在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且无红色报错。
