应将JAVA_HOME配置写入~/.zshenv文件，因其被所有zsh进程（包括GUI应用启动的shell）无条件加载，而~/.zshrc仅适用于交互式非登录shell，VS Code等GUI应用无法保证读取；同时需删除~/.zshrc或~/.zprofile中重复的JAVA_HOME导出语句以防冲突。
在 macOS Ventura 系统中，即使你执行了 export JAVA_HOME=$(/usr/libexec/java_home) 并 source 了配置文件，终端里 echo $JAVA_HOME 显示路径正确，java -version 也能运行，但 Maven、Gradle 或 VS Code 仍报错 “JAVA_HOME is not defined correctly”，说明环境变量未被子进程或 GUI 应用继承——这不是配置错了，而是 shell 配置未被系统级会话加载。
确认当前 shell 类型并定位配置文件
打开终端，执行：
zsh --version
若输出含 zsh（Ventura 默认），则配置文件优先级为：~/.zshenv → ~/.zprofile → ~/.zshrc。其中 ~/.zshenv 是唯一被所有 zsh 进程（包括 GUI 应用启动的 shell）无条件读取的文件，而 ~/.zshrc 仅被交互式非登录 shell 加载（比如你手动开的终端），VS Code 内置终端就属于这类，但它不保证读取 ~/.zshrc；GUI 应用如 IntelliJ 更是完全不加载它。
执行 echo $SHELL 确认当前 shell 路径，再运行 ls -la ~/.zshenv ~/.zprofile ~/.zshrc 2>/dev/null 查看哪些文件存在。
将 JAVA_HOME 写入 ~/.zshenv（关键一步）
方法一：直接写入（推荐）
执行：echo 'export JAVA_HOME=$(/usr/libexec/java_home)' >> ~/.zshenvecho 'export PATH=$JAVA_HOME/bin:$PATH' >> ~/.zshenv
立即学习“Java免费学习笔记（深入）”；
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
方法二：手动编辑（更可控）
运行 nano ~/.zshenv，粘贴以下两行（注意不要有多余空格或中文标点）：
export JAVA_HOME=$(/usr/libexec/java_home)
export PATH=$JAVA_HOME/bin:$PATH
按 Ctrl+O → Enter → Ctrl+X 保存退出。
【必须删除 ~/.zshrc 或 ~/.zprofile 中重复的 JAVA_HOME 导出语句】，否则多处定义可能冲突，尤其当某处路径错误时会覆盖 ~/.zshenv 的正确值。
验证 JAVA_HOME 是否被 GUI 应用识别
第一步：关闭所有已打开的终端窗口和 VS Code、IntelliJ 等 IDE。
第二步：从「启动台」或「访达→应用程序」中重新打开 VS Code（不是从终端用 code . 启动）。
第三步：在 VS Code 内置终端中执行：
echo $JAVA_HOME → 应输出类似 /Library/Java/JavaVirtualMachines/jdk-17.0.8.jdk/Contents/Home
java -version → 应显示与上述路径匹配的 JDK 版本
mvn -v → 若提示 “JAVA_HOME is not defined correctly”，说明 Maven 仍没读到，继续下一步。
第四步：为 Maven 单独加固（可选）
编辑 Maven 的启动脚本：sudo nano /opt/homebrew/opt/maven/bin/mvn（Homebrew 安装路径）或 /usr/local/Cellar/maven/*/bin/mvn（若用 brew cask）
在第一行 #!/bin/sh 下插入：export JAVA_HOME=$(/usr/libexec/java_home)
保存后重试 mvn -v。
