java -version无反应主因是PATH未配置JDK的bin目录，需手动添加；javac报错而java正常说明只装了JRE；中文路径或空格会导致失败，建议重装至无空格路径；Mac/Linux需同步配置JAVA_HOME和PATH并source生效。
cmd里输入 java -version 没反应？先看PATH有没有指向JDK的bin目录
很多人输完命令直接回车，黑窗一闪而过或报“不是内部或外部命令”，本质是系统根本找不到java.exe。Windows不会自动把JDK安装路径加进环境变量，必须手动配。
- 确认JDK已安装（比如装在
C:\Program Files\Java\jdk-17.0.1），然后找到里面的bin子目录（路径类似C:\Program Files\Java\jdk-17.0.1\bin） - 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”里找
PATH，编辑它，末尾追加上面那个bin路径（注意用英文分号;隔开） - 新开一个cmd窗口再试——旧窗口不会自动继承新环境变量
javac 报错但 java -version 正常？说明只装了JRE，没装JDK
java 命令能运行只代表有运行环境（JRE），而 javac 是编译器，属于JDK专属。很多用户从官网下了“Java Runtime”或误选了精简包，结果没有编译能力。
- 去 Oracle 或 OpenJDK 官网下载带
JDK字样的安装包（如jdk-17_windows-x64_bin.exe），别下JRE或JDK Demo这类变体 - 安装时留意是否勾选了“Add to PATH”，但即便勾选了，也建议手动核对
PATH里指向的是jdk-x.x而非jre-x.x - 验证：运行
where java和where javac，两个输出路径应该同属一个JDK根目录；如果javac找不到，或者路径指向C:\Program Files\Java\jre1.8.0_301\bin\javac.exe，那肯定不对
中文路径或空格导致 java -version 失败？JDK不支持带空格的安装路径
Windows默认把JDK装到 C:\Program Files\Java\...，这个 Program Files 中的空格会让某些老版本JDK启动脚本解析出错，尤其在IDE或构建工具调用时更隐蔽。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 最稳妥做法：重装JDK到无空格、无中文路径，比如
C:\jdk17或D:\java\jdk-21 - 如果不想重装，可尝试用短路径名绕过（例如
C:\Progra~1\Java\...），但不推荐——不同系统短名可能不同，且部分工具根本不认 - 检查方式：在cmd中执行
echo %JAVA_HOME%，如果输出含空格又没引号包裹，大概率会出问题；JAVA_HOME应该设为JDK根目录（如C:\jdk17），而非bin目录
Mac/Linux下 java -version 显示旧版本？别只改$PATH，还要检查$JAVA_HOME和shell配置文件
macOS有时预装了老版Java，即使你装了新JDK，终端仍优先用系统自带的。Linux则常见bash/zsh配置混乱，PATH 改了但没生效。
立即学习“Java免费学习笔记（深入）”；
- 先查真实路径：
which java和/usr/libexec/java_home -V（macOS专用），看列出的JDK版本和路径 - 把新JDK路径写进
~/.zshrc（macOS Catalina+）或~/.bash_profile，例如：export JAVA_HOME=$(/usr/libexec/java_home -v 17)，再export PATH=$JAVA_HOME/bin:$PATH - 关键一步：执行
source ~/.zshrc（或对应文件），否则当前终端还是旧环境；新开终端也得重新source，除非你重启shell
