前置条件必须提前安装好 JDK并配置好JAVA_HOME环境变量Maven 运行依赖 JDK如果没有配置JAVA_HOME执行 mvn 命令会报JAVA‑HOME not found。推荐版本JDK8 / JDK17Maven 3.9.x一、下载 Maven官网地址Download Apache Maven – Maven快捷下载点击下载文件选择Windows 系统✅Binary zip archive二进制压缩包日常开发选这个❌ Source zip archive源码包二次开发才下载解压注意事项解压路径不要带中文、空格、特殊字符示例路径E:\software\apache‑maven‑3.9.15❌ 不推荐E:\Maven\apache‑maven‑3.9.15\repo仓库放解压目录内升级 maven 容易误删仓库✅ 推荐本地仓库单独建文件夹E:\maven‑repository二、配置 Windows 环境变量右键「此电脑」→【属性】→【高级系统设置】→【环境变量】在系统变量区域点击【新建】变量名MAVEN_HOME变量值Maven 解压后的根目录例E:\software\apache‑maven‑3.9.15在系统变量列表找到Path点击【编辑】→【新建】添加值%MAVEN_HOME%\bin可点击上移调高加载优先级全部窗口依次点「确定」保存备选变量名M2_HOME部分老工具识别二选一即可推荐 MAVEN_HOME环境变量校验WinR输入cmd打开命令提示符失败时用管理员身份运行 CMD执行命令mvn -v # 等价命令 mvn --version正常输出 Maven、Java 版本信息 环境变量成功报错mvn 不是内部或外部命令环境变量配置错误重新检查 MAVEN_HOME 与 Path三、核心配置 settings.xml配置文件路径maven根目录/conf/settings.xml需要配置三项本地仓库路径、阿里云镜像、默认 JDK 编译版本1配置本地仓库找到注释的本地仓库代码复制出来修改为你的仓库路径。Windows 路径分隔符推荐/或者\\不要用单独一个\!-- 本地依赖仓库所有下载的jar包缓存到此目录 -- localRepositoryE:/maven-repository/localRepository默认仓库位置不配置时C:\Users\你的用户名\.m2\repository2配置阿里云镜像解决国外中央仓库下载慢找到标签mirrors/mirrors在标签内部添加镜像配置mirror idaliyun-maven/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/public/url blockedfalse/blocked /mirrormirrorOfcentral/mirrorOf代表镜像替代官方中央仓库不要写错。3配置全局默认 JDK 编译版本放到profiles/profiles标签内部二选一不要同时开启两个activeByDefaulttrueJDK 1.8profile idjdk-1.8/id activation activeByDefaulttrue/activeByDefault jdk1.8/jdk /activation properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target maven.compiler.compilerVersion1.8/maven.compiler.compilerVersion /properties /profileJDK 17profile idjdk-17/id activation activeByDefaulttrue/activeByDefault jdk17/jdk /activation properties maven.compiler.source17/maven.compiler.source maven.compiler.target17/maven.compiler.target maven.compiler.compilerVersion17/maven.compiler.compilerVersion /properties /profile✅ 完整成品 settings.xml直接复制可用修改localRepository的路径为你自己的仓库目录即可?xml version1.0 encodingUTF-8? settings xmlnshttp://maven.apache.org/SETTINGS/1.2.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd !-- 本地仓库路径 -- localRepositoryE:/maven-repository/localRepository mirrors !-- 阿里云镜像 -- mirror idaliyun-maven/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/public/url blockedfalse/blocked /mirror /mirrors profiles !-- JDK 1.8 -- profile idjdk-1.8/id activation activeByDefaulttrue/activeByDefault jdk1.8/jdk /activation properties maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target maven.compiler.compilerVersion1.8/maven.compiler.compilerVersion /properties /profile /profiles /settings校验 settings.xml 是否生效CMD 执行命令会自动下载基础依赖到你的本地仓库mvn help:system命令无报错仓库文件夹出现文件 → Maven 配置成功。四、IDEA 配置 Maven全局配置新建项目自动生效IDEA 欢迎页 →Customize→All Settings新版本叫 Settings for New Projects1.Maven 主设置搜索MavenMaven home path选择你解压好的 maven 根目录User settings file勾选Override选中你修改好的conf/settings.xmlLocal repository勾选Override自动识别你 settings 配置的仓库路径2.Maven‑Runner 配置切换到Runner子选项卡JRE选择对应版本 JDK和 settings 里面 JDK 版本保持一致3.Importing 导入配置Importing标签设置 JDK 版本导入项目时使用4.Java Compiler 编译设置搜索Java CompilerProject bytecode version和你的 JDK 版本匹配8 /17依次点击Apply→OK保存全部设置。附加小优化设置 → System Settings取消勾选Reopen projects on startup禁止 IDEA 自动打开上次项目。五、常见问题排查汇总mvn -v提示不是内部命令环境变量没生效关闭所有 cmd 窗口重新打开检查 MAVEN_HOME 路径Path 配置下载依赖速度很慢检查 mirror 镜像是否写在mirrors标签内IDEA 项目 JDK 版本一直不对三处统一版本系统 settings.xml、IDEA Maven Runner、Java Compiler 字节码版本仓库没有下载 jar 包mvn help:system测试连通性检查 settings.xml 有没有语法报错标签没闭合