No valid Maven installation found. Either set the home directory in the configuration dialog

### 解决方案

对于IDEA导入Maven项目时报错`No valid Maven installation found. Either set the home directory in the configuration dialog or set the M2_HOME environment variable on your system.`的情况，可以通过两种主要方式来解决问题[^1]。

#### 方法一：通过IDEA内部配置Maven Home Directory

在IntelliJ IDEA中可以直接指定Maven的安装路径：

1. 进入 `File | Settings`(Windows/Linux) 或 `IntelliJ IDEA | Preferences`(macOS).
2. 转至 `Build, Execution, Deployment | Build Tools | Maven`.
3. 设置`Maven home path`为本地计算机上的Maven安装位置.
4. 应用更改并重启IDEA.

此方法适用于希望仅针对当前IDE实例配置Maven环境的情形.

#### 方法二：设置系统级别的M2_HOME环境变量

另一种解决方案是在操作系统级别定义`M2_HOME`环境变量:

- **Windows**: 控制面板 -> 系统和安全 -> 系统 -> 高级系统设置 -> 环境变量 -> 新建名为`M2_HOME`指向Maven解压后的根文件夹；同时更新Path变量加入%M2_HOME%\bin。

- **Linux/macOS**: 编辑~/.bashrc或对应的shell profile文件，添加如下两行(假设Maven位于`/opt/apache-maven`)：

export M2_HOME=/opt/apache-maven
export PATH=$PATH:$M2_HOME/bin

完成上述任一步骤之后，请验证命令行下的mvn版本能否被识别(`mvn -version`). 如果可以，则说明配置成功[^3].

为了进一步确认IDEA中的Maven配置是否生效，在IDEA内打开终端执行相同指令也可以帮助判断问题所在[^4].