最常见原因是环境变量未配置，需先设JAVA_HOME再将其bin目录加入PATH；确认JDK已安装并获取根路径，分别在系统环境变量或shell配置文件中设置JAVA_HOME和PATH，最后通过java -version等命令验证。
命令行输入 java 报错，最常见原因是系统找不到 Java 可执行文件，本质是环境变量没配好。核心就两步：设好 JAVA_HOME，再把它加进 PATH。
确认 JDK 已安装并找到路径
先确保你确实装了 JDK（不是只有 JRE）。打开命令行，输入：
java -version
如果提示“不是内部或外部命令”，说明 JDK 可能没装，或只装了 JRE。去官网下载 JDK（推荐 LTS 版本如 Java 17 或 21），安装后记下完整路径，例如：
立即学习“Java免费学习笔记（深入）”；
- Windows：
C:\Program Files\Java\jdk-17.0.2 - macOS：
/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home - Linux：
/usr/lib/jvm/jdk-17.0.2
注意：路径里不能带 bin，也不能加引号。
Java 接口排错助手
下载
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
设置 JAVA_HOME 变量
这个变量告诉系统“JDK 安装在哪”，是其他工具（Maven、IDE 等）识别 Java 的依据。
-
Windows：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”→在“系统变量”里点“新建”，变量名填
JAVA_HOME，变量值填上面记下的 JDK 根路径。 -
macOS/Linux：打开终端，编辑 shell 配置文件（如
~/.zshrc或~/.bash_profile），末尾添加一行：export JAVA_HOME=/你的/JDK/路径
然后运行source ~/.zshrc（或对应文件）使配置生效。
把 javac 和 java 加进 PATH
PATH 决定了系统在哪些目录里找命令。你需要把 JDK 的 bin 目录加进去。
-
Windows：仍在“环境变量”窗口，在“系统变量”中找到
Path，点击“编辑”→“新建”，输入：%JAVA_HOME%\bin
（不要手敲完整路径，用%JAVA_HOME%更安全、易维护） -
macOS/Linux：在同一个 shell 配置文件里，再加一行：
export PATH=$JAVA_HOME/bin:$PATH
验证是否成功
关掉所有旧命令行窗口，新开一个，依次执行：
echo %JAVA_HOME%（Windows）或 echo $JAVA_HOME（macOS/Linux）→ 应该显示你的 JDK 路径
java -version → 显示版本号，比如 java version "17.0.2"
javac -version → 同样显示版本号
全部通过，说明配置完成。如果某一步失败，重点检查路径是否拼错、变量名是否大小写准确、新窗口是否已打开。
