核心是正确配置JAVA_HOME和Path变量：JAVA_HOME指向JDK根目录（如D:\Java\jdk-21），Path添加%JAVA_HOME%\bin，重启命令行后执行java --version和javac --version均显示一致版本即成功。

Java 环境变量配置的核心是让系统知道 JDK 安装在哪、以及如何调用 java 和 javac 命令。只要配对 JAVA_HOME 和 Path 这两个变量，99% 的“不是内部或外部命令”问题就能解决。

确认 JDK 已正确安装

打开命令提示符（cmd），输入：

java -version

如果显示类似 java version "17.0.2"，说明 JDK 已装好；如果提示“不是内部或外部命令”，说明还没装或装了但没配置。请先从 Adoptium 或 Oracle 下载并安装 JDK（推荐 JDK 17 或 JDK 21 LTS 版本），记住安装路径，例如：
D:\Java\jdk-21 或 C:\Program Files\Eclipse Adoptium\jdk-21.0.1.12-hotspot。

设置 JAVA_HOME 系统变量

这是指向 JDK 根目录的“定位锚”，其他工具（如 Maven、Tomcat、IDEA）都依赖它：

• 按 Win + R，输入 sysdm.cpl 回车 → 切换到“高级”选项卡 → 点击“环境变量”
• 在“系统变量”区域点击【新建】
• 变量名填：JAVA_HOME
• 变量值填：JDK 安装根目录（不含 \bin，例如 D:\Java\jdk-21）
• 注意：路径中含空格（如 Program Files）时，后续 Path 引用需加英文双引号，更稳妥的做法是把 JDK 装到无空格路径

把 bin 目录加入 Path

Path 决定了你在哪都能直接敲 java 或 javac：

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 在“系统变量”中找到 Path，双击编辑
• 点击【新建】，添加一行：%JAVA_HOME%\bin
• 建议将这一行移到列表靠前位置（避免被旧 Java 路径覆盖）
• 如果 JDK 路径含空格，可写成："%JAVA_HOME%\bin"（带英文双引号）

验证是否配置成功

必须新开一个命令提示符窗口（已打开的不会自动读取新变量）：

依次执行：

java --version
javac --version

两个命令都输出版本号（且版本一致），即表示配置完成。若只有 java 成功而 javac 失败，说明 Path 指向的是 JRE 而非 JDK —— 请检查 JAVA_HOME 是否指向完整 JDK 目录（内含 bin\javac.exe）。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南