Maven的下载安装配置与使用文章目录Maven的下载安装配置与使用前言一、Maven简介1.什么是 Maven2.Maven的核心概念二、Maven 安装与配置以Windows为例Linux/macOS类似1.下载Maven2. 安装 Maven3. 验证安装三、Maven 项目结构,pom.xml,setting.xml1. 标准项目结构2.pom.xml 示例3.setting.xml四、Maven常用命令五、Maven 依赖管理1.依赖范围Scope2. 排除冲突依赖六、常见问题解决总结前言一、Maven简介1.什么是 Maven1.Apache Maven 是一个项目管理工具主要用于 Java 项目的构建、依赖管理 和 项目信息管理。2.核心功能a.自动化构建编译、测试、打包、部署。b.依赖管理自动下载和管理第三方库。c.标准化项目结构。2.Maven的核心概念概念说明POM (Project Object Model)项目配置文件 pom.xml定义项目依赖、构建配置等。坐标 (Coordinates)通过 groupId, artifactId, version 唯一标识一个依赖包。仓库 (Repository)本地仓库本地缓存目录默认 ~/.m2/repository中央仓库Maven 官方远程仓库存储所有公共依赖私服企业自建仓库如 Nexus。生命周期 (Lifecycle)构建流程的标准化阶段如 clean, compile, test, package, install。二、Maven 安装与配置以Windows为例Linux/macOS类似1.下载Mavenapache官网下载https://maven.apache.org/download.cgi2. 安装 Maven解压压缩包到指定目录如 E:\apache-maven-3.8.1。配置环境变量1.新建系统变量 MAVEN_HOME值为 Maven 解压路径如E:\apache-maven-3.8.1。2.编辑 Path 变量添加 %MAVEN_HOME%\bin或E:\apache-maven-3.8.1-bin\apache-maven-3.8.1\bin。3. 验证安装打开命令行输入以下命令,结果如下图表示安装成功mvn-v三、Maven 项目结构,pom.xml,setting.xml1. 标准项目结构my-project/ ├── src/ │ ├── main/ │ │ ├── java/# 主代码目录│ │ └── resources/# 配置文件目录│ └── test/ │ ├── java/# 测试代码目录│ └── resources/# 测试配置文件├── target/# 构建输出目录└── pom.xml# 项目配置文件2.pom.xml 示例projectmodelVersion4.0.0/modelVersion!-- 坐标 --groupIdcom.example/groupIdartifactIdmy-project/artifactIdversion1.0.0/version!-- 依赖管理 --dependenciesdependencygroupIdjunit/groupIdartifactIdjunit/artifactIdversion4.13.2/versionscopetest/scope/dependency/dependencies!-- 构建配置 --buildpluginsplugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-compiler-plugin/artifactIdversion3.11.0/versionconfigurationsource21/sourcetarget21/target/configuration/plugin/plugins/build/project3.setting.xml1.本地仓库localRepository本地机器上的依赖存储目录默认 ~/.m2/repository。本地仓库的依赖可以实现跨本地项目的共享依赖引用中央仓库Maven Centralhttps://mvnrepository.com/镜像服务器(中央仓库)mirroraliyun镜像。3.profile用于定义一组可动态激活的配置规则它允许开发者根据不同的环境如开发、测试、生产或需求如不同操作系统、JDK 版本灵活切换构建行为。profile 是 Maven 实现多环境配置管理的核心机制。a.核心作用场景说明多环境适配根据环境变量、操作系统等条件自动切换仓库地址、依赖版本、插件配置等。条件化构建仅在特定条件下启用某些插件或参数如跳过测试、启用代码覆盖率检查。全局配置复用在 settings.xml 中定义的 profile 可作用于所有项目与 pom.xml 中的 profile 不同。b.配置结构settingsprofiles!-- 定义一个名为dev的 Profile --profile!-- 唯一标识符通过-P或条件激活时使用 --iddev/id!-- 激活条件可选满足条件时自动激活 --activationactiveByDefaulttrue/activeByDefault!-- 默认激活 --propertynameenv/name!-- 当存在-Denvdev 时激活 --valuedev/value/propertyosfamilyWindows/family!-- 仅在 Windows 系统激活 --/os/activation!-- Profile 的具体配置内容 --propertiesdatabase.urljdbc:mysql://localhost:3306/dev_db/database.url/propertiesrepositoriesrepositoryidaliyun-maven/idurlhttps://maven.aliyun.com/repository/public/url/repository/repositoriespluginRepositoriespluginRepositoryidaliyun-plugins/idurlhttps://maven.aliyun.com/repository/public/url/pluginRepository/pluginRepositories/profile/profiles/settingsc.关键配置项解析配置项说明idProfile 的唯一标识符如 dev, prod, jdk11。activation定义自动激活条件如系统属性、文件存在、操作系统等。properties定义键值对参数可在 pom.xml 中通过 ${key} 引用。repositories覆盖默认的远程仓库地址常用于私服配置。pluginRepositories覆盖插件的远程仓库地址。d.激活方式自动激活通过 activation条件activation!-- 当系统属性env的值为prod时激活 --propertynameenv/namevalueprod/value/property!-- 当文件src/env/prod存在时激活 --fileexistssrc/env/prod/exists/file!-- 仅在 JDK21或更高版本激活 --jdk21/jdk/activation手动激活:命令行指定通过-P参数激活指定 Profile mvn cleaninstall-Pdev,test全局默认激活在 settings.xml 中配置activeProfilesactiveProfiledev/activeProfile/activeProfiles典型应用场景:场景 1多环境数据库配置场景 2: 为不同操作系统配置不同插件xml注意事项:优先级规则1.settings.xml 中的 profile 优先级低于 pom.xml 2.中的 profile。同文件中多个 profile 的配置会合并重复项以最后定义的为准。调试 Profile1.使用 mvn help:active-profiles 查看当前激活的 Profile。2.使用 mvn help:all-profiles 列出所有可用 Profile。避免滥用1.若配置仅针对单个项目应优先在 pom.xml 中定义 Profile。2.settings.xml 中的 Profile 适用于全局配置如企业私服地址。四、Maven常用命令命令说明mvn clean清理 target 目录。mvn compile编译主代码。mvn test运行单元测试。mvn package打包项目生成 JAR/WAR 文件到 target 目录。mvn install安装项目到本地仓库供其他项目依赖。mvn dependency:tree查看项目依赖树。mvn archetype:generate使用模板生成新项目。五、Maven 依赖管理1.依赖范围ScopeScope说明compile默认值参与编译、测试、运行。test仅参与测试阶段如 JUnit。provided由 JDK 或容器提供如 Servlet APIruntime仅参与运行阶段如 JDBC 驱动。2. 排除冲突依赖dependencygroupIdorg.example/groupIdartifactIdexample-lib/artifactIdversion1.0.0/versionexclusionsexclusiongroupIdconflict-group/groupIdartifactIdconflict-artifact/artifactId/exclusion/exclusions/dependency六、常见问题解决依赖下载失败原因网络问题或仓库地址错误。解决1.检查 Maven 配置文件 settings.xml位于 conf/ 目录。2.更换镜像源如阿里云镜像mirroridaliyun/idmirrorOf*/mirrorOfnameAliyun Maven Mirror/nameurlhttps://maven.aliyun.com/repository/public/url/mirror构建速度慢优化方式1.增加 Maven 内存在 MAVEN_OPTS 环境变量中设置 -Xmx1024m。2.使用并行构建mvn -T 4 clean install4 线程。总结Maven 是 Java 生态的核心工具熟练掌握可极大提升开发效率。推荐 IDE 集成IntelliJ IDEA/Eclipse 均支持 Maven 项目无缝操作。延伸学习结合 Nexus 搭建私服、学习 Gradle 作为补充构建工具。