1. 什么是 MavenMaven 是一个基于项目对象模型POM的项目管理和构建自动化工具主要用于 Java 项目的构建、依赖管理和项目信息管理。它由 Apache 软件基金会维护是目前 Java 生态中最流行的构建工具之一。Maven 的核心思想是约定优于配置Convention over Configuration通过提供一套标准的项目结构和构建生命周期让开发者无需为每个项目单独编写构建脚本从而将精力集中在业务逻辑开发上。1.1 Maven 能做什么依赖管理自动下载和管理项目所需的第三方库及其传递依赖项目构建编译、测试、打包、部署等一键完成项目信息管理生成项目文档、站点、报告等多模块支持方便管理大型项目的多个子模块统一构建标准所有 Maven 项目遵循相同的构建流程2. Maven 的安装与配置2.1 环境要求在安装 Maven 之前需要确保系统已安装 JDK。Maven 3.9 要求 JDK 8 及以上版本。2.2 下载与安装Windows 系统访问 Maven 官网 下载二进制压缩包解压到指定目录例如D:\apache-maven-3.9.6配置环境变量新建系统变量MAVEN_HOME值为解压目录在Path变量中添加%MAVEN_HOME%\binLinux/macOS 系统# 下载并解压wgethttps://dlcdn.apache.org/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gztar-xzfapache-maven-3.9.6-bin.tar.gzsudomvapache-maven-3.9.6 /opt/maven# 配置环境变量exportMAVEN_HOME/opt/mavenexportPATH$PATH:$MAVEN_HOME/bin2.3 验证安装打开命令行终端执行以下命令验证 Maven 是否安装成功mvn-version如果安装成功会输出类似以下信息Apache Maven 3.9.6 (bc2320e3f4cf87b5e233a0f3f0f0f5f5f5f5f5f5) Maven home: /opt/maven Java version: 17.0.9, vendor: Oracle Corporation Java home: /usr/lib/jvm/java-17-openjdk Default locale: zh_CN, platform encoding: UTF-83. Maven 核心概念3.1 POMProject Object ModelPOM 是 Maven 的核心配置文件文件名为pom.xml位于项目根目录。它定义了项目的基本信息、依赖、构建配置等。一个最基本的pom.xml示例如下?xml version1.0 encodingUTF-8?projectxmlnshttp://maven.apache.org/POM/4.0.0xmlns:xsihttp://www.w3.org/2001/XMLSchema-instancexsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsdmodelVersion4.0.0/modelVersiongroupIdcom.example/groupIdartifactIdmy-project/artifactIdversion1.0.0/versionpackagingjar/packagingpropertiesmaven.compiler.source17/maven.compiler.sourcemaven.compiler.target17/maven.compiler.targetproject.build.sourceEncodingUTF-8/project.build.sourceEncoding/propertiesdependencies!-- 依赖声明 --/dependencies/project3.2 坐标CoordinatesMaven 坐标用于唯一标识一个项目或依赖由以下三个元素组成groupId组织或项目的唯一标识通常为域名倒写如com.exampleartifactId项目或模块的名称如my-projectversion版本号如1.0.03.3 仓库RepositoryMaven 仓库用于存储构建产物和依赖分为三类本地仓库默认位于~/.m2/repository用于缓存下载的依赖中央仓库Maven 官方提供的远程仓库地址为https://repo.maven.apache.org/maven2私有仓库企业或团队内部搭建的仓库如 Nexus、Artifactory3.4 生命周期LifecycleMaven 定义了三个独立的标准生命周期clean清理构建产物default项目构建的核心生命周期包含编译、测试、打包、安装等阶段site生成项目站点文档default 生命周期的主要阶段包括阶段说明validate验证项目配置是否正确compile编译项目源代码test运行单元测试package打包成 jar/war 等格式verify对集成测试结果进行检查install将构建产物安装到本地仓库deploy将构建产物部署到远程仓库4. 创建 Maven 项目4.1 使用命令行创建Maven 提供了archetype插件来快速创建项目骨架mvn archetype:generate-DgroupIdcom.example-DartifactIddemo-project-DarchetypeArtifactIdmaven-archetype-quickstart-DinteractiveModefalse执行后会自动生成以下目录结构demo-project/ ├── pom.xml └── src/ ├── main/ │ └── java/ │ └── com/example/ │ └── App.java └── test/ └── java/ └── com/example/ └── AppTest.java4.2 标准目录结构Maven 项目遵循标准的目录结构project-root/ ├── pom.xml ├── src/ │ ├── main/ │ │ ├── java/ # 主代码 │ │ ├── resources/ # 资源文件 │ │ └── webapp/ # Web 项目资源war 包 │ └── test/ │ ├── java/ # 测试代码 │ └── resources/ # 测试资源 └── target/ # 构建输出目录4.3 使用 IDE 创建在 IntelliJ IDEA 或 Eclipse 中可以直接通过图形界面创建 Maven 项目选择File → New → Project选择Maven作为项目类型填写 groupId、artifactId 和 version点击Finish完成创建5. 依赖管理5.1 添加依赖在pom.xml的dependencies标签中添加依赖声明dependencies!-- JUnit 单元测试 --dependencygroupIdorg.junit.jupiter/groupIdartifactIdjunit-jupiter/artifactIdversion5.10.2/versionscopetest/scope/dependency!-- Spring Boot Web --dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactIdversion3.2.5/version/dependency!-- MySQL 驱动 --dependencygroupIdcom.mysql/groupIdartifactIdmysql-connector-j/artifactIdversion8.3.0/version/dependency/dependencies5.2 依赖范围ScopeMaven 支持以下几种依赖范围范围说明示例compile默认范围编译和运行时都可用业务依赖provided编译时可用运行时由容器提供Servlet APIruntime编译时不需要运行时需要JDBC 驱动test仅测试时可用JUnitsystem使用系统路径不推荐使用本地 jar5.3 依赖传递与冲突Maven 会自动传递依赖但可能产生版本冲突。解决冲突的原则最短路径优先路径越短的依赖版本优先先声明优先路径相同时先声明的依赖版本优先可以使用以下命令查看依赖树mvn dependency:tree6. 常用 Maven 命令6.1 构建相关命令# 清理并编译mvn clean compile# 运行测试mvntest# 打包跳过测试mvn package-DskipTests# 安装到本地仓库mvninstall# 部署到远程仓库mvn deploy6.2 项目信息命令# 查看依赖树mvn dependency:tree# 查看项目信息mvn help:describe-Dplugincompiler# 生成项目站点mvn site6.3 常用参数# 跳过测试mvn package-DskipTests# 指定配置文件mvn package-Pprod# 离线模式mvn compile-o# 多线程构建mvn package-T47. 多模块项目7.1 创建父模块大型项目通常拆分为多个模块父模块的pom.xml使用modules声明子模块projectmodelVersion4.0.0/modelVersiongroupIdcom.example/groupIdartifactIdparent-project/artifactIdversion1.0.0/versionpackagingpom/packagingmodulesmodulecommon/modulemoduleservice/modulemoduleweb/module/modules/project7.2 子模块继承子模块通过parent继承父模块的配置projectparentgroupIdcom.example/groupIdartifactIdparent-project/artifactIdversion1.0.0/version/parentartifactIdservice/artifactId/project7.3 统一依赖管理在父模块中使用dependencyManagement统一管理依赖版本dependencyManagementdependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-dependencies/artifactIdversion3.2.5/versiontypepom/typescopeimport/scope/dependency/dependencies/dependencyManagement8. 常用插件配置8.1 编译插件buildpluginsplugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-compiler-plugin/artifactIdversion3.13.0/versionconfigurationsource17/sourcetarget17/targetencodingUTF-8/encoding/configuration/plugin/plugins/build8.2 Spring Boot 打包插件plugingroupIdorg.springframework.boot/groupIdartifactIdspring-boot-maven-plugin/artifactIdversion3.2.5/versionconfigurationmainClasscom.example.Application/mainClass/configurationexecutionsexecutiongoalsgoalrepackage/goal/goals/execution/executions/plugin8.3 跳过测试插件配置plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-surefire-plugin/artifactIdversion3.2.5/versionconfigurationskipTeststrue/skipTests/configuration/plugin9. 常见问题与解决方案9.1 依赖下载失败问题Maven 无法下载依赖提示连接超时或 401 错误。解决方案检查网络连接确认可以访问中央仓库配置阿里云镜像加速下载检查本地仓库是否损坏删除~/.m2/repository中对应目录后重新下载9.2 配置阿里云镜像在~/.m2/settings.xml中配置镜像mirrorsmirroridaliyunmaven/idmirrorOfcentral/mirrorOfname阿里云公共仓库/nameurlhttps://maven.aliyun.com/repository/public/url/mirror/mirrors9.3 编译编码问题问题编译时出现乱码或编码警告。解决方案在pom.xml中显式指定编码propertiesproject.build.sourceEncodingUTF-8/project.build.sourceEncoding/properties9.4 版本冲突问题问题项目中出现NoSuchMethodError或ClassNotFoundException。解决方案使用mvn dependency:tree查看依赖树使用exclusions排除冲突依赖在dependencyManagement中统一指定版本dependencygroupIdcom.example/groupIdartifactIdsome-lib/artifactIdversion2.0.0/versionexclusionsexclusiongroupIdorg.slf4j/groupIdartifactIdslf4j-api/artifactId/exclusion/exclusions/dependency10. 总结Maven 作为 Java 生态中最成熟的项目管理工具通过标准化的项目结构和自动化的依赖管理极大地提升了开发效率。掌握 Maven 的核心概念和常用命令是每个 Java 开发者的必备技能。在实际项目中建议遵循 Maven 的标准目录结构合理使用依赖范围避免不必要的依赖使用dependencyManagement统一管理版本配置国内镜像加速依赖下载多模块项目合理拆分降低耦合度希望本文能帮助你快速上手 Maven在实际项目中灵活运用。
1. 什么是 MavenMaven 是一个基于项目对象模型POM的项目管理和构建自动化工具主要用于 Java 项目的构建、依赖管理和项目信息管理。它由 Apache 软件基金会维护是目前 Java 生态中最流行的构建工具之一。Maven 的核心思想是约定优于配置Convention over Configuration通过提供一套标准的项目结构和构建生命周期让开发者无需为每个项目单独编写构建脚本从而将精力集中在业务逻辑开发上。1.1 Maven 能做什么依赖管理自动下载和管理项目所需的第三方库及其传递依赖项目构建编译、测试、打包、部署等一键完成项目信息管理生成项目文档、站点、报告等多模块支持方便管理大型项目的多个子模块统一构建标准所有 Maven 项目遵循相同的构建流程2. Maven 的安装与配置2.1 环境要求在安装 Maven 之前需要确保系统已安装 JDK。Maven 3.9 要求 JDK 8 及以上版本。2.2 下载与安装Windows 系统访问 Maven 官网 下载二进制压缩包解压到指定目录例如D:\apache-maven-3.9.6配置环境变量新建系统变量MAVEN_HOME值为解压目录在Path变量中添加%MAVEN_HOME%\binLinux/macOS 系统# 下载并解压wgethttps://dlcdn.apache.org/maven/maven-3/3.9.6/binaries/apache-maven-3.9.6-bin.tar.gztar-xzfapache-maven-3.9.6-bin.tar.gzsudomvapache-maven-3.9.6 /opt/maven# 配置环境变量exportMAVEN_HOME/opt/mavenexportPATH$PATH:$MAVEN_HOME/bin2.3 验证安装打开命令行终端执行以下命令验证 Maven 是否安装成功mvn-version如果安装成功会输出类似以下信息Apache Maven 3.9.6 (bc2320e3f4cf87b5e233a0f3f0f0f5f5f5f5f5f5) Maven home: /opt/maven Java version: 17.0.9, vendor: Oracle Corporation Java home: /usr/lib/jvm/java-17-openjdk Default locale: zh_CN, platform encoding: UTF-83. Maven 核心概念3.1 POMProject Object ModelPOM 是 Maven 的核心配置文件文件名为pom.xml位于项目根目录。它定义了项目的基本信息、依赖、构建配置等。一个最基本的pom.xml示例如下?xml version1.0 encodingUTF-8?projectxmlnshttp://maven.apache.org/POM/4.0.0xmlns:xsihttp://www.w3.org/2001/XMLSchema-instancexsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsdmodelVersion4.0.0/modelVersiongroupIdcom.example/groupIdartifactIdmy-project/artifactIdversion1.0.0/versionpackagingjar/packagingpropertiesmaven.compiler.source17/maven.compiler.sourcemaven.compiler.target17/maven.compiler.targetproject.build.sourceEncodingUTF-8/project.build.sourceEncoding/propertiesdependencies!-- 依赖声明 --/dependencies/project3.2 坐标CoordinatesMaven 坐标用于唯一标识一个项目或依赖由以下三个元素组成groupId组织或项目的唯一标识通常为域名倒写如com.exampleartifactId项目或模块的名称如my-projectversion版本号如1.0.03.3 仓库RepositoryMaven 仓库用于存储构建产物和依赖分为三类本地仓库默认位于~/.m2/repository用于缓存下载的依赖中央仓库Maven 官方提供的远程仓库地址为https://repo.maven.apache.org/maven2私有仓库企业或团队内部搭建的仓库如 Nexus、Artifactory3.4 生命周期LifecycleMaven 定义了三个独立的标准生命周期clean清理构建产物default项目构建的核心生命周期包含编译、测试、打包、安装等阶段site生成项目站点文档default 生命周期的主要阶段包括阶段说明validate验证项目配置是否正确compile编译项目源代码test运行单元测试package打包成 jar/war 等格式verify对集成测试结果进行检查install将构建产物安装到本地仓库deploy将构建产物部署到远程仓库4. 创建 Maven 项目4.1 使用命令行创建Maven 提供了archetype插件来快速创建项目骨架mvn archetype:generate-DgroupIdcom.example-DartifactIddemo-project-DarchetypeArtifactIdmaven-archetype-quickstart-DinteractiveModefalse执行后会自动生成以下目录结构demo-project/ ├── pom.xml └── src/ ├── main/ │ └── java/ │ └── com/example/ │ └── App.java └── test/ └── java/ └── com/example/ └── AppTest.java4.2 标准目录结构Maven 项目遵循标准的目录结构project-root/ ├── pom.xml ├── src/ │ ├── main/ │ │ ├── java/ # 主代码 │ │ ├── resources/ # 资源文件 │ │ └── webapp/ # Web 项目资源war 包 │ └── test/ │ ├── java/ # 测试代码 │ └── resources/ # 测试资源 └── target/ # 构建输出目录4.3 使用 IDE 创建在 IntelliJ IDEA 或 Eclipse 中可以直接通过图形界面创建 Maven 项目选择File → New → Project选择Maven作为项目类型填写 groupId、artifactId 和 version点击Finish完成创建5. 依赖管理5.1 添加依赖在pom.xml的dependencies标签中添加依赖声明dependencies!-- JUnit 单元测试 --dependencygroupIdorg.junit.jupiter/groupIdartifactIdjunit-jupiter/artifactIdversion5.10.2/versionscopetest/scope/dependency!-- Spring Boot Web --dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactIdversion3.2.5/version/dependency!-- MySQL 驱动 --dependencygroupIdcom.mysql/groupIdartifactIdmysql-connector-j/artifactIdversion8.3.0/version/dependency/dependencies5.2 依赖范围ScopeMaven 支持以下几种依赖范围范围说明示例compile默认范围编译和运行时都可用业务依赖provided编译时可用运行时由容器提供Servlet APIruntime编译时不需要运行时需要JDBC 驱动test仅测试时可用JUnitsystem使用系统路径不推荐使用本地 jar5.3 依赖传递与冲突Maven 会自动传递依赖但可能产生版本冲突。解决冲突的原则最短路径优先路径越短的依赖版本优先先声明优先路径相同时先声明的依赖版本优先可以使用以下命令查看依赖树mvn dependency:tree6. 常用 Maven 命令6.1 构建相关命令# 清理并编译mvn clean compile# 运行测试mvntest# 打包跳过测试mvn package-DskipTests# 安装到本地仓库mvninstall# 部署到远程仓库mvn deploy6.2 项目信息命令# 查看依赖树mvn dependency:tree# 查看项目信息mvn help:describe-Dplugincompiler# 生成项目站点mvn site6.3 常用参数# 跳过测试mvn package-DskipTests# 指定配置文件mvn package-Pprod# 离线模式mvn compile-o# 多线程构建mvn package-T47. 多模块项目7.1 创建父模块大型项目通常拆分为多个模块父模块的pom.xml使用modules声明子模块projectmodelVersion4.0.0/modelVersiongroupIdcom.example/groupIdartifactIdparent-project/artifactIdversion1.0.0/versionpackagingpom/packagingmodulesmodulecommon/modulemoduleservice/modulemoduleweb/module/modules/project7.2 子模块继承子模块通过parent继承父模块的配置projectparentgroupIdcom.example/groupIdartifactIdparent-project/artifactIdversion1.0.0/version/parentartifactIdservice/artifactId/project7.3 统一依赖管理在父模块中使用dependencyManagement统一管理依赖版本dependencyManagementdependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-dependencies/artifactIdversion3.2.5/versiontypepom/typescopeimport/scope/dependency/dependencies/dependencyManagement8. 常用插件配置8.1 编译插件buildpluginsplugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-compiler-plugin/artifactIdversion3.13.0/versionconfigurationsource17/sourcetarget17/targetencodingUTF-8/encoding/configuration/plugin/plugins/build8.2 Spring Boot 打包插件plugingroupIdorg.springframework.boot/groupIdartifactIdspring-boot-maven-plugin/artifactIdversion3.2.5/versionconfigurationmainClasscom.example.Application/mainClass/configurationexecutionsexecutiongoalsgoalrepackage/goal/goals/execution/executions/plugin8.3 跳过测试插件配置plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-surefire-plugin/artifactIdversion3.2.5/versionconfigurationskipTeststrue/skipTests/configuration/plugin9. 常见问题与解决方案9.1 依赖下载失败问题Maven 无法下载依赖提示连接超时或 401 错误。解决方案检查网络连接确认可以访问中央仓库配置阿里云镜像加速下载检查本地仓库是否损坏删除~/.m2/repository中对应目录后重新下载9.2 配置阿里云镜像在~/.m2/settings.xml中配置镜像mirrorsmirroridaliyunmaven/idmirrorOfcentral/mirrorOfname阿里云公共仓库/nameurlhttps://maven.aliyun.com/repository/public/url/mirror/mirrors9.3 编译编码问题问题编译时出现乱码或编码警告。解决方案在pom.xml中显式指定编码propertiesproject.build.sourceEncodingUTF-8/project.build.sourceEncoding/properties9.4 版本冲突问题问题项目中出现NoSuchMethodError或ClassNotFoundException。解决方案使用mvn dependency:tree查看依赖树使用exclusions排除冲突依赖在dependencyManagement中统一指定版本dependencygroupIdcom.example/groupIdartifactIdsome-lib/artifactIdversion2.0.0/versionexclusionsexclusiongroupIdorg.slf4j/groupIdartifactIdslf4j-api/artifactId/exclusion/exclusions/dependency10. 总结Maven 作为 Java 生态中最成熟的项目管理工具通过标准化的项目结构和自动化的依赖管理极大地提升了开发效率。掌握 Maven 的核心概念和常用命令是每个 Java 开发者的必备技能。在实际项目中建议遵循 Maven 的标准目录结构合理使用依赖范围避免不必要的依赖使用dependencyManagement统一管理版本配置国内镜像加速依赖下载多模块项目合理拆分降低耦合度希望本文能帮助你快速上手 Maven在实际项目中灵活运用。
