1. 项目缘起为什么在Win10上配置Maven值得单独写一篇如果你刚接触Java开发或者从别的项目转过来可能会觉得“配置Maven”不就是下载、解压、设个环境变量的事儿吗网上教程一搜一大把为什么还要专门写一篇我刚开始也这么想直到后来带新人、处理各种环境问题才发现这里面藏着不少“暗坑”。一个看似简单的配置背后是理解Java生态构建工具链的起点配置不当轻则项目构建缓慢、依赖下载失败重则团队协作时出现“在我机器上是好的”这种经典难题。Maven的核心价值在于“约定大于配置”和依赖管理。在Windows 10上由于系统权限、路径格式特别是包含空格或中文的路径、以及与其他开发环境如IDE的交互配置过程比在Linux或macOS上更容易遇到“玄学”问题。这篇内容我会结合我这些年踩过的坑和总结的最佳实践带你走一遍从零开始到配置出一个健壮、高效、易于维护的Maven环境全过程。我们不止要“配通”更要理解每一步背后的意图以及如何为未来的团队协作和复杂项目打下基础。2. 核心组件准备JDK与Maven的版本选择与安装在配置Maven之前有一个绝对的前置条件Java Development Kit (JDK)。Maven本身是Java程序它运行需要JRE而编译你的项目需要JDK。很多人在这里第一步就错了。2.1 JDK的选择与安装验证首先不要使用系统可能自带的JRE务必安装完整的JDK。版本上目前业界主流且稳定的选择仍然是JDK 8 (1.8) 或 JDK 11LTS长期支持版。对于新项目我建议直接上JDK 11或更新的LTS版本如JDK 17但考虑到大量遗留项目的兼容性JDK 1.8依然是“万金油”。这里以JDK 1.8为例但原理相通。下载前往Oracle官网或更推荐的开源发行版如AdoptOpenJDK、Amazon Corretto的官网下载Windows x64安装程序。安装时注意记录安装路径例如C:\Program Files\Java\jdk1.8.0_391。强烈建议路径中不要有空格或中文虽然新版工具对此支持好了很多但避免总是最好的。验证安装安装完成后打开命令提示符CMD或 PowerShell输入java -version和javac -version。如果正确显示版本信息说明JDK已安装但还未配置全局环境变量因此这两个命令可能只在安装目录下有效。我们下一步配置环境变量就是为了让系统在任何位置都能识别这些命令。2.2 Maven的下载与目录结构解析接下来是主角Maven。同样去Apache Maven官网下载最新稳定版如3.9.x的二进制压缩包Binary zip archive。选择zip包而不是安装程序因为更干净也更容易管理多个版本。下载后将其解压到一个你喜欢的目录。我的习惯是创建一个统一的C:\DevTools目录专门存放这些开发工具比如C:\DevTools\apache-maven-3.9.6。解压后的目录结构是这样的apache-maven-3.9.6/ ├── bin/ # 包含运行脚本mvn命令就在这里 ├── boot/ # 包含类加载器框架 ├── conf/ # **核心配置文件目录重中之重** ├── lib/ # Maven运行时依赖的库 └── LICENSE/NOTICE/README.txt这里你需要重点关注conf目录。里面有一个settings.xml文件这是Maven的全局配置文件。我们后续修改仓库位置、配置镜像等操作主要就是修改这个文件。先知道位置后面会细讲。3. 环境变量配置不只是设个PATH那么简单环境变量是Windows系统提供的一种机制让应用程序包括命令行能够找到可执行文件、库或配置信息。配置Maven需要设置两个核心变量JAVA_HOME和MAVEN_HOME或M2_HOME并将它们添加到PATH中。3.1 配置JAVA_HOMEJAVA_HOME指向的是你的JDK安装根目录不是JRE目录也不是bin目录。右键点击“此电脑” - “属性” - “高级系统设置” - “环境变量”。在“系统变量”部分点击“新建”。变量名JAVA_HOME变量值你的JDK安装路径例如C:\Program Files\Java\jdk1.8.0_391找到系统变量中的Path变量选中并点击“编辑”。点击“新建”添加一项%JAVA_HOME%\bin。这一步的作用是当你在命令行输入java或javac时系统会去JAVA_HOME定义的路径下的bin目录里寻找。注意很多教程让你在Path里直接加JDK的bin全路径这当然可以但使用%JAVA_HOME%\bin是更优的做法。好处是当你未来需要切换或升级JDK版本时你只需要修改JAVA_HOME这一个变量的值Path会自动生效无需再动。这是一种解耦和便于维护的思路。3.2 配置MAVEN_HOME与Path同理为Maven创建变量。在“系统变量”中点击“新建”。变量名MAVEN_HOME(或M2_HOME两者皆可MAVEN_HOME更通用)变量值你的Maven解压目录例如C:\DevTools\apache-maven-3.9.6再次编辑Path变量新建一项%MAVEN_HOME%\bin。3.3 验证配置这是关键一步不要跳过。关闭所有已打开的命令行窗口因为环境变量需要在新窗口中生效重新打开一个CMD或PowerShell。依次执行以下命令进行验证java -version javac -version mvn -v如果mvn -v成功输出Maven版本、Java版本、操作系统信息等那么恭喜你基础环境配置成功。如果报错“mvn不是内部或外部命令”请回头检查MAVEN_HOME的路径是否正确以及Path中是否包含了%MAVEN_HOME%\bin并确保重启了命令行。4. 定制化配置让Maven真正“好用”默认配置的Maven能用但不好用。主要问题在于默认的本地仓库在C盘用户目录下~/.m2/repository随着项目增多会撑爆系统盘且默认从中央仓库位于国外下载依赖速度慢如蜗牛还经常超时。下面我们进行两项最重要的定制。4.1 修改本地仓库位置本地仓库是你电脑上存储所有从网络下载的jar包的地方。把它移到空间充裕的非系统盘。在你喜欢的位置创建一个目录例如D:\MavenRepository。同样路径避免中文和空格。打开Maven安装目录下的conf/settings.xml文件。建议用Notepad、VS Code等文本编辑器打开不要用Windows自带的记事本可能编码有问题。找到被注释掉的localRepository标签。它大概长这样!-- localRepository | The path to the local repository maven will use to store artifacts. | | Default: ${user.home}/.m2/repository localRepository/path/to/local/repo/localRepository --将其取消注释并修改为你的自定义路径localRepositoryD:\MavenRepository/localRepository实操心得这个路径一定要用正斜杠/或者双反斜杠\\。直接使用D:\MavenRepository有时在XML解析中可能会出问题写成D:/MavenRepository是兼容性最好的方式。4.2 配置国内镜像仓库这是大幅提升下载速度的关键。我们将Maven中央仓库的地址映射到国内的镜像服务器比如阿里云、华为云等。在conf/settings.xml文件中找到mirrors标签段。在里面添加一个新的mirror配置。以下是阿里云镜像的配置推荐速度快且稳定mirrors mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/central/url /mirror !-- 可以配置多个镜像但mirrorOf需要设置好避免冲突 -- /mirrorsid镜像的唯一标识可以自定义。mirrorOfcentral表示这个镜像是针对中央仓库repo.maven.apache.org的镜像。所有对中央仓库的请求都会被拦截并转到这个镜像地址。你也可以设置为*匹配所有仓库但要小心可能会覆盖你为特定仓库如公司私服的配置。url镜像仓库的实际地址。避坑指南有些教程会教你直接修改conf/settings.xml里的repositories那是错误的。repositories是定义在项目的pom.xml中用来声明项目使用哪些仓库。而在全局settings.xml中配置mirrors是一种透明的代理/替换机制对项目本身无侵入是更优雅和推荐的做法。另外配置完镜像后第一次构建可能会稍慢因为它在建立索引之后就会飞快。5. IDE集成在IntelliJ IDEA中配置Maven大部分Java开发都在IDE中进行因此IDE能否正确识别并使用我们配置的Maven至关重要。这里以IntelliJ IDEA为例Eclipse/VS Code原理类似。打开IntelliJ IDEA进入File-Settings(Windows) 或IntelliJ IDEA-Preferences(macOS)。在搜索框输入Maven找到Build, Execution, Deployment-Build Tools-Maven。你会看到三个关键的路径配置Maven home path这里要选择我们自定义的Maven安装目录例如C:\DevTools\apache-maven-3.9.6。不要使用IDEA内置的BundledMaven否则我们之前的全局配置就失效了。User settings file这是最容易出错的地方这里默认可能指向的是用户目录下的~/.m2/settings.xml。我们需要将它指向我们修改过的、Maven安装目录下的conf/settings.xml文件。点击右边的Override复选框然后选择C:\DevTools\apache-maven-3.9.6\conf\settings.xml。这样IDEA才会使用我们配置了本地仓库和镜像的配置文件。Local repository当你正确指定了User settings file后这个字段会自动更新为我们之前在settings.xml里设置的D:\MavenRepository。如果没有自动更新可以手动Override并指向该目录。点击Apply-OK。验证IDE配置在IDEA中打开右侧边栏的Maven工具窗口如果没看到View-Tool Windows-Maven。展开一个项目点击Lifecycle中的clean或compile观察底部的Run窗口输出。如果构建成功并且下载依赖的URL显示的是https://maven.aliyun.com/...说明镜像配置生效。同时去D:\MavenRepository目录下看看应该已经开始有jar包下载下来了。核心技巧团队协作时建议将这份定制好的conf/settings.xml文件共享给团队成员或者放在项目文档中。这样可以确保整个团队使用统一的仓库配置避免因环境差异导致的依赖问题。对于公司内部通常会搭建Nexus或Artifactory这样的私有仓库并在settings.xml中配置对应的server和mirror/profile原理是相通的。6. 高级配置与疑难排查基础配置完成后还有一些进阶设置和常见问题需要了解。6.1 配置HTTP代理如果你的网络环境需要通过代理服务器访问外网需要在settings.xml中配置代理。找到proxies标签段添加如下配置根据你的代理服务器情况修改proxies proxy idmy-proxy/id activetrue/active protocolhttp/protocol !-- 或 https -- hostproxy.yourcompany.com/host port8080/port !-- 如果代理不需要认证下面username和password可以省略 -- !-- usernameproxyuser/username -- !-- passwordproxypass/password -- !-- 通常不对本地地址使用代理 -- nonProxyHostslocalhost|127.0.0.1|*.local/nonProxyHosts /proxy /proxies6.2 常见问题排查“踩坑”实录即使按照步骤操作也可能遇到问题。下面是一些典型场景问题一mvn -v报错 “Error: JAVA_HOME not found in your environment.”排查这说明JAVA_HOME变量没被正确识别。首先在命令行输入echo %JAVA_HOME%看是否输出了正确路径。如果没有检查环境变量是否设置正确并确认你是在设置环境变量后新打开的命令行窗口。如果路径正确但仍有问题检查路径中是否包含特殊字符或空格尝试用双引号将%JAVA_HOME%包裹起来在Path中编辑时或者将JDK安装到无空格路径下。问题二构建时下载依赖极慢或报错 “Could not transfer artifact ... from/to central ...”排查首先确认镜像配置是否正确。检查settings.xml中mirror的url是否可以浏览器访问。检查网络连接和代理设置。如果你在公司内网可能需要配置代理见6.1。清理本地仓库的“半成品”。有时网络中断会导致依赖下载不完整形成一个以.lastUpdated结尾的文件。可以手动删除本地仓库中对应出错的依赖目录或者使用命令mvn dependency:purge-local-repository清理然后重新构建。检查Maven版本是否过旧。过旧的Maven版本可能与新的仓库协议或证书不兼容升级到3.6.x以上版本通常能解决很多网络问题。问题三IDEA中Maven项目依赖一直报红但命令行构建正常排查这几乎是IDE集成特有的问题。首先检查IDEA中的Maven配置第5步是否正确特别是User settings file是否指向了正确的、已修改的settings.xml。尝试点击IDEA右侧Maven工具窗口的“刷新”按钮一个循环箭头图标强制重新导入所有Maven项目。检查项目本身的pom.xml是否有语法错误。尝试“Invalidate Caches and Restart”文件 - 无效缓存并重启。IDEA的索引有时会出问题。在命令行进入项目根目录执行mvn clean compile -U(-U参数强制更新快照依赖)如果命令行成功再回到IDEA刷新通常能解决。问题四权限问题构建时提示“Access denied”或创建文件失败排查这在Windows上很常见尤其是当Maven或IDE以非管理员权限运行时尝试向受保护目录如C:\Program Files写入文件。根本解决确保Maven的安装路径、本地仓库路径都不在系统保护目录下。像我们之前建议的C:\DevTools或D:\MavenRepository就很好。如果已经发生可以尝试以管理员身份运行CMD或IDEA但这不是长久之计。最好还是迁移目录。7. 实战检验创建一个Maven项目并理解其生命周期配置好了我们来跑一个最简单的例子验证整个环境并理解Maven的核心——生命周期。打开命令行进入一个你准备存放代码的目录比如D:\Projects执行以下命令mvn archetype:generate -DgroupIdcom.example -DartifactIdmy-first-app -DarchetypeArtifactIdmaven-archetype-quickstart -DinteractiveModefalse这条命令使用Maven的“项目原型”插件快速生成一个标准的Java项目骨架。-DgroupIdcom.example 定义项目组织或公司的唯一标识通常用反写域名。-DartifactIdmy-first-app 定义项目本身的唯一标识也是项目根目录名。-DarchetypeArtifactIdmaven-archetype-quickstart 指定使用“快速开始”原型模板。命令执行成功后你会看到一个名为my-first-app的文件夹。其结构如下my-first-app/ ├── pom.xml # 项目对象模型Maven的核心配置文件 └── src/ ├── main/ │ └── java/ │ └── com/ │ └── example/ │ └── App.java # 自动生成的示例类 └── test/ └── java/ └── com/ └── example/ └── AppTest.java # 自动生成的测试类进入项目目录执行经典的Maven命令cd my-first-app mvn clean compile你会看到Maven开始执行一系列动作清理clean旧的编译输出然后编译compile主代码。在这个过程中它会解析pom.xml下载项目所需的依赖本例中只有JUnit编译App.java。如果一切顺利最后会显示BUILD SUCCESS。再执行mvn clean package这个命令会依次执行clean、compile、test运行单元测试、package打包阶段。最终在target目录下生成一个my-first-app-1.0-SNAPSHOT.jar文件。这就是Maven生命周期模型的体现你只需要指定最终阶段如packageMaven会自动执行该阶段之前的所有默认阶段。打开pom.xml文件看看你会看到我们定义的groupId,artifactId,version这三者合称坐标GAV以及项目依赖junit。Maven就是通过这个文件来管理项目的构建、依赖和报告的。
1. 项目缘起为什么在Win10上配置Maven值得单独写一篇如果你刚接触Java开发或者从别的项目转过来可能会觉得“配置Maven”不就是下载、解压、设个环境变量的事儿吗网上教程一搜一大把为什么还要专门写一篇我刚开始也这么想直到后来带新人、处理各种环境问题才发现这里面藏着不少“暗坑”。一个看似简单的配置背后是理解Java生态构建工具链的起点配置不当轻则项目构建缓慢、依赖下载失败重则团队协作时出现“在我机器上是好的”这种经典难题。Maven的核心价值在于“约定大于配置”和依赖管理。在Windows 10上由于系统权限、路径格式特别是包含空格或中文的路径、以及与其他开发环境如IDE的交互配置过程比在Linux或macOS上更容易遇到“玄学”问题。这篇内容我会结合我这些年踩过的坑和总结的最佳实践带你走一遍从零开始到配置出一个健壮、高效、易于维护的Maven环境全过程。我们不止要“配通”更要理解每一步背后的意图以及如何为未来的团队协作和复杂项目打下基础。2. 核心组件准备JDK与Maven的版本选择与安装在配置Maven之前有一个绝对的前置条件Java Development Kit (JDK)。Maven本身是Java程序它运行需要JRE而编译你的项目需要JDK。很多人在这里第一步就错了。2.1 JDK的选择与安装验证首先不要使用系统可能自带的JRE务必安装完整的JDK。版本上目前业界主流且稳定的选择仍然是JDK 8 (1.8) 或 JDK 11LTS长期支持版。对于新项目我建议直接上JDK 11或更新的LTS版本如JDK 17但考虑到大量遗留项目的兼容性JDK 1.8依然是“万金油”。这里以JDK 1.8为例但原理相通。下载前往Oracle官网或更推荐的开源发行版如AdoptOpenJDK、Amazon Corretto的官网下载Windows x64安装程序。安装时注意记录安装路径例如C:\Program Files\Java\jdk1.8.0_391。强烈建议路径中不要有空格或中文虽然新版工具对此支持好了很多但避免总是最好的。验证安装安装完成后打开命令提示符CMD或 PowerShell输入java -version和javac -version。如果正确显示版本信息说明JDK已安装但还未配置全局环境变量因此这两个命令可能只在安装目录下有效。我们下一步配置环境变量就是为了让系统在任何位置都能识别这些命令。2.2 Maven的下载与目录结构解析接下来是主角Maven。同样去Apache Maven官网下载最新稳定版如3.9.x的二进制压缩包Binary zip archive。选择zip包而不是安装程序因为更干净也更容易管理多个版本。下载后将其解压到一个你喜欢的目录。我的习惯是创建一个统一的C:\DevTools目录专门存放这些开发工具比如C:\DevTools\apache-maven-3.9.6。解压后的目录结构是这样的apache-maven-3.9.6/ ├── bin/ # 包含运行脚本mvn命令就在这里 ├── boot/ # 包含类加载器框架 ├── conf/ # **核心配置文件目录重中之重** ├── lib/ # Maven运行时依赖的库 └── LICENSE/NOTICE/README.txt这里你需要重点关注conf目录。里面有一个settings.xml文件这是Maven的全局配置文件。我们后续修改仓库位置、配置镜像等操作主要就是修改这个文件。先知道位置后面会细讲。3. 环境变量配置不只是设个PATH那么简单环境变量是Windows系统提供的一种机制让应用程序包括命令行能够找到可执行文件、库或配置信息。配置Maven需要设置两个核心变量JAVA_HOME和MAVEN_HOME或M2_HOME并将它们添加到PATH中。3.1 配置JAVA_HOMEJAVA_HOME指向的是你的JDK安装根目录不是JRE目录也不是bin目录。右键点击“此电脑” - “属性” - “高级系统设置” - “环境变量”。在“系统变量”部分点击“新建”。变量名JAVA_HOME变量值你的JDK安装路径例如C:\Program Files\Java\jdk1.8.0_391找到系统变量中的Path变量选中并点击“编辑”。点击“新建”添加一项%JAVA_HOME%\bin。这一步的作用是当你在命令行输入java或javac时系统会去JAVA_HOME定义的路径下的bin目录里寻找。注意很多教程让你在Path里直接加JDK的bin全路径这当然可以但使用%JAVA_HOME%\bin是更优的做法。好处是当你未来需要切换或升级JDK版本时你只需要修改JAVA_HOME这一个变量的值Path会自动生效无需再动。这是一种解耦和便于维护的思路。3.2 配置MAVEN_HOME与Path同理为Maven创建变量。在“系统变量”中点击“新建”。变量名MAVEN_HOME(或M2_HOME两者皆可MAVEN_HOME更通用)变量值你的Maven解压目录例如C:\DevTools\apache-maven-3.9.6再次编辑Path变量新建一项%MAVEN_HOME%\bin。3.3 验证配置这是关键一步不要跳过。关闭所有已打开的命令行窗口因为环境变量需要在新窗口中生效重新打开一个CMD或PowerShell。依次执行以下命令进行验证java -version javac -version mvn -v如果mvn -v成功输出Maven版本、Java版本、操作系统信息等那么恭喜你基础环境配置成功。如果报错“mvn不是内部或外部命令”请回头检查MAVEN_HOME的路径是否正确以及Path中是否包含了%MAVEN_HOME%\bin并确保重启了命令行。4. 定制化配置让Maven真正“好用”默认配置的Maven能用但不好用。主要问题在于默认的本地仓库在C盘用户目录下~/.m2/repository随着项目增多会撑爆系统盘且默认从中央仓库位于国外下载依赖速度慢如蜗牛还经常超时。下面我们进行两项最重要的定制。4.1 修改本地仓库位置本地仓库是你电脑上存储所有从网络下载的jar包的地方。把它移到空间充裕的非系统盘。在你喜欢的位置创建一个目录例如D:\MavenRepository。同样路径避免中文和空格。打开Maven安装目录下的conf/settings.xml文件。建议用Notepad、VS Code等文本编辑器打开不要用Windows自带的记事本可能编码有问题。找到被注释掉的localRepository标签。它大概长这样!-- localRepository | The path to the local repository maven will use to store artifacts. | | Default: ${user.home}/.m2/repository localRepository/path/to/local/repo/localRepository --将其取消注释并修改为你的自定义路径localRepositoryD:\MavenRepository/localRepository实操心得这个路径一定要用正斜杠/或者双反斜杠\\。直接使用D:\MavenRepository有时在XML解析中可能会出问题写成D:/MavenRepository是兼容性最好的方式。4.2 配置国内镜像仓库这是大幅提升下载速度的关键。我们将Maven中央仓库的地址映射到国内的镜像服务器比如阿里云、华为云等。在conf/settings.xml文件中找到mirrors标签段。在里面添加一个新的mirror配置。以下是阿里云镜像的配置推荐速度快且稳定mirrors mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/central/url /mirror !-- 可以配置多个镜像但mirrorOf需要设置好避免冲突 -- /mirrorsid镜像的唯一标识可以自定义。mirrorOfcentral表示这个镜像是针对中央仓库repo.maven.apache.org的镜像。所有对中央仓库的请求都会被拦截并转到这个镜像地址。你也可以设置为*匹配所有仓库但要小心可能会覆盖你为特定仓库如公司私服的配置。url镜像仓库的实际地址。避坑指南有些教程会教你直接修改conf/settings.xml里的repositories那是错误的。repositories是定义在项目的pom.xml中用来声明项目使用哪些仓库。而在全局settings.xml中配置mirrors是一种透明的代理/替换机制对项目本身无侵入是更优雅和推荐的做法。另外配置完镜像后第一次构建可能会稍慢因为它在建立索引之后就会飞快。5. IDE集成在IntelliJ IDEA中配置Maven大部分Java开发都在IDE中进行因此IDE能否正确识别并使用我们配置的Maven至关重要。这里以IntelliJ IDEA为例Eclipse/VS Code原理类似。打开IntelliJ IDEA进入File-Settings(Windows) 或IntelliJ IDEA-Preferences(macOS)。在搜索框输入Maven找到Build, Execution, Deployment-Build Tools-Maven。你会看到三个关键的路径配置Maven home path这里要选择我们自定义的Maven安装目录例如C:\DevTools\apache-maven-3.9.6。不要使用IDEA内置的BundledMaven否则我们之前的全局配置就失效了。User settings file这是最容易出错的地方这里默认可能指向的是用户目录下的~/.m2/settings.xml。我们需要将它指向我们修改过的、Maven安装目录下的conf/settings.xml文件。点击右边的Override复选框然后选择C:\DevTools\apache-maven-3.9.6\conf\settings.xml。这样IDEA才会使用我们配置了本地仓库和镜像的配置文件。Local repository当你正确指定了User settings file后这个字段会自动更新为我们之前在settings.xml里设置的D:\MavenRepository。如果没有自动更新可以手动Override并指向该目录。点击Apply-OK。验证IDE配置在IDEA中打开右侧边栏的Maven工具窗口如果没看到View-Tool Windows-Maven。展开一个项目点击Lifecycle中的clean或compile观察底部的Run窗口输出。如果构建成功并且下载依赖的URL显示的是https://maven.aliyun.com/...说明镜像配置生效。同时去D:\MavenRepository目录下看看应该已经开始有jar包下载下来了。核心技巧团队协作时建议将这份定制好的conf/settings.xml文件共享给团队成员或者放在项目文档中。这样可以确保整个团队使用统一的仓库配置避免因环境差异导致的依赖问题。对于公司内部通常会搭建Nexus或Artifactory这样的私有仓库并在settings.xml中配置对应的server和mirror/profile原理是相通的。6. 高级配置与疑难排查基础配置完成后还有一些进阶设置和常见问题需要了解。6.1 配置HTTP代理如果你的网络环境需要通过代理服务器访问外网需要在settings.xml中配置代理。找到proxies标签段添加如下配置根据你的代理服务器情况修改proxies proxy idmy-proxy/id activetrue/active protocolhttp/protocol !-- 或 https -- hostproxy.yourcompany.com/host port8080/port !-- 如果代理不需要认证下面username和password可以省略 -- !-- usernameproxyuser/username -- !-- passwordproxypass/password -- !-- 通常不对本地地址使用代理 -- nonProxyHostslocalhost|127.0.0.1|*.local/nonProxyHosts /proxy /proxies6.2 常见问题排查“踩坑”实录即使按照步骤操作也可能遇到问题。下面是一些典型场景问题一mvn -v报错 “Error: JAVA_HOME not found in your environment.”排查这说明JAVA_HOME变量没被正确识别。首先在命令行输入echo %JAVA_HOME%看是否输出了正确路径。如果没有检查环境变量是否设置正确并确认你是在设置环境变量后新打开的命令行窗口。如果路径正确但仍有问题检查路径中是否包含特殊字符或空格尝试用双引号将%JAVA_HOME%包裹起来在Path中编辑时或者将JDK安装到无空格路径下。问题二构建时下载依赖极慢或报错 “Could not transfer artifact ... from/to central ...”排查首先确认镜像配置是否正确。检查settings.xml中mirror的url是否可以浏览器访问。检查网络连接和代理设置。如果你在公司内网可能需要配置代理见6.1。清理本地仓库的“半成品”。有时网络中断会导致依赖下载不完整形成一个以.lastUpdated结尾的文件。可以手动删除本地仓库中对应出错的依赖目录或者使用命令mvn dependency:purge-local-repository清理然后重新构建。检查Maven版本是否过旧。过旧的Maven版本可能与新的仓库协议或证书不兼容升级到3.6.x以上版本通常能解决很多网络问题。问题三IDEA中Maven项目依赖一直报红但命令行构建正常排查这几乎是IDE集成特有的问题。首先检查IDEA中的Maven配置第5步是否正确特别是User settings file是否指向了正确的、已修改的settings.xml。尝试点击IDEA右侧Maven工具窗口的“刷新”按钮一个循环箭头图标强制重新导入所有Maven项目。检查项目本身的pom.xml是否有语法错误。尝试“Invalidate Caches and Restart”文件 - 无效缓存并重启。IDEA的索引有时会出问题。在命令行进入项目根目录执行mvn clean compile -U(-U参数强制更新快照依赖)如果命令行成功再回到IDEA刷新通常能解决。问题四权限问题构建时提示“Access denied”或创建文件失败排查这在Windows上很常见尤其是当Maven或IDE以非管理员权限运行时尝试向受保护目录如C:\Program Files写入文件。根本解决确保Maven的安装路径、本地仓库路径都不在系统保护目录下。像我们之前建议的C:\DevTools或D:\MavenRepository就很好。如果已经发生可以尝试以管理员身份运行CMD或IDEA但这不是长久之计。最好还是迁移目录。7. 实战检验创建一个Maven项目并理解其生命周期配置好了我们来跑一个最简单的例子验证整个环境并理解Maven的核心——生命周期。打开命令行进入一个你准备存放代码的目录比如D:\Projects执行以下命令mvn archetype:generate -DgroupIdcom.example -DartifactIdmy-first-app -DarchetypeArtifactIdmaven-archetype-quickstart -DinteractiveModefalse这条命令使用Maven的“项目原型”插件快速生成一个标准的Java项目骨架。-DgroupIdcom.example 定义项目组织或公司的唯一标识通常用反写域名。-DartifactIdmy-first-app 定义项目本身的唯一标识也是项目根目录名。-DarchetypeArtifactIdmaven-archetype-quickstart 指定使用“快速开始”原型模板。命令执行成功后你会看到一个名为my-first-app的文件夹。其结构如下my-first-app/ ├── pom.xml # 项目对象模型Maven的核心配置文件 └── src/ ├── main/ │ └── java/ │ └── com/ │ └── example/ │ └── App.java # 自动生成的示例类 └── test/ └── java/ └── com/ └── example/ └── AppTest.java # 自动生成的测试类进入项目目录执行经典的Maven命令cd my-first-app mvn clean compile你会看到Maven开始执行一系列动作清理clean旧的编译输出然后编译compile主代码。在这个过程中它会解析pom.xml下载项目所需的依赖本例中只有JUnit编译App.java。如果一切顺利最后会显示BUILD SUCCESS。再执行mvn clean package这个命令会依次执行clean、compile、test运行单元测试、package打包阶段。最终在target目录下生成一个my-first-app-1.0-SNAPSHOT.jar文件。这就是Maven生命周期模型的体现你只需要指定最终阶段如packageMaven会自动执行该阶段之前的所有默认阶段。打开pom.xml文件看看你会看到我们定义的groupId,artifactId,version这三者合称坐标GAV以及项目依赖junit。Maven就是通过这个文件来管理项目的构建、依赖和报告的。
