彻底清理Java环境变量需检查并清除系统/用户变量中的JAVA_HOME、JRE_HOME及Path内所有Java相关路径（含%JAVA_HOME%\bin、C:\Program Files\Java\等），macOS/Linux还需编辑~/.zshrc或~/.bashrc中export语句，最后新开终端用echo、where/which和java -version验证是否清空。
彻底清理 Java 环境变量，关键在于找全所有可能被修改的位置，并逐个清除与 Java 相关的配置项。只删掉 JAVA_HOME 或只改 Path 中的一处，往往不够——残留路径仍会干扰新版本运行。
Windows：检查并删除全部环境变量位置
右键“此电脑” → “属性” → “高级系统设置” → “环境变量”，需检查以下三处：
-
系统变量中删除：
JAVA_HOME、JRE_HOME（如有） -
系统变量的
Path中删除：
• 所有形如%JAVA_HOME%\bin的条目
• 所有以C:\Program Files\Java\、C:\Program Files (x86)\Java\开头的完整路径
• 包含jdk-、jre-或Java\字样的路径 -
用户变量中同样检查
JAVA_HOME和Path，一并清理（尤其当曾用普通用户权限安装过 JDK）
macOS / Linux：定位并编辑 Shell 配置文件
打开终端，根据你实际使用的 Shell 查找对应配置文件：
- Zsh（macOS Catalina 及之后默认）→ 编辑
~/.zshrc或~/.zprofile - Bash → 编辑
~/.bash_profile或~/.bashrc - 通用方式：运行
echo $SHELL确认当前 Shell，再用cat ~/.zshrc | grep -i java（或替换为对应文件名）快速筛查
删除或注释掉所有含 export JAVA_HOME=、export PATH=...java...、PATH=".../jdk-.../bin:$PATH" 的行。
验证是否清干净
关闭所有终端/命令提示符窗口，**新开一个**，然后执行：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
echo $JAVA_HOME（macOS/Linux）或echo %JAVA_HOME%（Windows）→ 应返回空行 -
where java（Windows）或which java（macOS/Linux）→ 应无输出或提示“not found” -
java -version→ 显示“不是内部或外部命令”或“command not found”
若任一命令仍有输出，说明还有隐藏路径未清理，需回溯检查。
容易被忽略的“影子变量”
某些 IDE（如 IntelliJ）、构建工具（如 Gradle Wrapper）或旧脚本可能在项目级或临时环境中硬编码 Java 路径。如果清理后仍出现异常，可临时在终端中运行：
-
set | grep -i java（Linux/macOS）或set | findstr java（Windows）→ 查看当前会话中是否意外设置了变量 - 检查 IDE 的“Project Structure”或“SDKs”设置页，确认未保留旧 JDK 引用
不复杂但容易忽略。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
