在配置环境变量之后使用Maven报错 ： mvn : 无法将“mvn”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。

最近，我在 Windows 系统上安装和配置 Apache Maven 时遇到了一些问题，想在此记录下我的解决历程，希望对遇到类似问题的朋友有所帮助。

问题描述

我下载了 Maven 并按照常规步骤配置了相关的环境变量。然而，在 PowerShell 中输入 mvn -v 时，系统提示：

mvn : 无法将“mvn”识别为 cmdlet、函数、脚本文件或可运行程序的名称。

一开始，我以为是 Maven 版本的问题。于是，我多次尝试下载官网上的不同版本，配置环境变量，无论是用户变量还是系统环境变量，依然无法正常使用 mvn -v。

排查步骤

1. 确认 Maven 环境变量配置： 在 PowerShell 中使用 echo %MAVEN_HOME%/bin，输出结果是正确的路径，说明我的 MAVEN_HOME 变量配置是正常的。

   示例：

   echo %MAVEN_HOME%/bin
   

   2. 路径配置： 检查了 Path 变量，确保已经包含了 %MAVEN_HOME%\bin。

        Path 变量配置：

%MAVEN_HOME%\bin

 

3. 重启 PowerShell： 每次修改完环境变量后，我都重启了 PowerShell 终端以应用最新的配置。

关键发现

经过多次尝试后，我开始怀疑问题可能出在 JAVA_HOME 环境变量的配置上。Maven 依赖于 Java 环境，如果没有正确配置 JAVA_HOME，Maven 是无法运行的。

于是，我检查了我的 JAVA_HOME 变量，发现它根本没有被配置。配置 JAVA_HOME 后，问题得到了完美解决。

解决步骤

1. 配置 JAVA_HOME：

   • 打开系统环境变量设置界面。
   • 新建一个 JAVA_HOME 变量，将其值设为 JDK 的安装路径，例如：

   • C:\Program Files\Java\jdk-17
     

     验证配置： 配置完 JAVA_HOME 和 MAVEN_HOME 变量后，重新打开 PowerShell输入：mvn -v

   • 

 配置成功