Maven 从入门到精通2025-2026 最新实用版Maven 是 Java 生态中最主流的项目构建和管理工具几乎所有现代 Java 项目Spring Boot、微服务、大型企业级系统都离不开它。它帮你解决依赖地狱、统一构建流程、标准化项目结构三大痛点。本文从零基础到生产级实践一条线带你吃透 Maven。1. Maven 到底解决了什么问题为什么你要学没有 Maven 的时代痛点手动下载 JAR 包 → 版本冲突 → 依赖传递问题每个人构建命令不同ant、gradle、shell 脚本……项目结构五花八门新人接手成本极高测试、打包、部署流程不统一Maven 带来的改变核心价值统一标准目录结构、构建生命周期、依赖坐标依赖自动管理中央仓库 传递依赖 版本统一插件生态编译、测试、打包、生成文档、docker 构建……跨平台同一套 pom.xmlWindows / Linux / Mac 都能跑一句话Maven 让“构建”这件事从艺术变成了工程。2. 快速入门10 分钟上手步骤1安装 Maven2025-2026 推荐方式下载https://maven.apache.org/download.cgi推荐最新稳定版目前 3.9.x 系列环境变量最重要一步M2_HOME D:\apache-maven-3.9.x MAVEN_HOME %M2_HOME%部分系统也认这个 Path %M2_HOME%\bin验证mvn -version看到 Maven 版本 Java 版本即成功推荐镜像中国大陆必配编辑~/.m2/settings.xml没有就新建settingsmirrorsmirroridaliyunmaven/idmirrorOfcentral/mirrorOfnamealiyun maven/nameurlhttps://maven.aliyun.com/repository/public/url/mirror/mirrors/settings步骤2创建第一个 Maven 项目命令行方式最纯正mvn archetype:generate -DgroupIdcom.example -DartifactIdmy-first-maven -DarchetypeArtifactIdmaven-archetype-quickstart -DinteractiveModefalseIDEA / VS Code 方式推荐New Project → Maven → 选择 quickstart 骨架生成后目录结构记住这套约定my-first-maven ├── pom.xml └── src ├── main │ ├── java ← 主代码 │ └── resources ← 配置文件、properties、xml 等 └── test ├── java ← 测试代码 └── resources ← 测试资源步骤3核心命令背下来命令含义使用频率mvn clean删除 target 目录★★★★mvn compile编译主代码★★mvn test编译 运行单元测试★★★★mvn package打包jar/war★★★★★mvn install打包 安装到本地仓库★★★★mvn deploy发布到私服★★mvn clean install -U强制更新依赖 安装常用最常用组合mvn clean install -U3. Maven 核心概念必须吃透3.1 POMProject Object Model — 项目描述文件projectmodelVersion4.0.0/modelVersion!-- 坐标全世界唯一标识 --groupIdcom.company/groupIdartifactIdmy-app/artifactIdversion1.0.0-SNAPSHOT/versionpackagingjar/packaging!-- jar / war / pom / maven-plugin --name项目名称/namedescription一句话描述/description!-- 属性统一管理版本 --propertiesjava.version17/java.versionspring-boot.version3.2.5/spring-boot.version/properties!-- 依赖管理 --dependencyManagement.../dependencyManagement!-- 实际依赖 --dependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactIdversion${spring-boot.version}/version/dependency/dependenciesbuildplugins.../plugins/build/project3.2 坐标GAV — 全球唯一定位groupId公司/组织反写域名artifactId项目名/模块名version版本号推荐语义化主.次.增量-SNAPSHOT3.3 依赖范围scope — 超重要scope含义编译时测试时运行时打包进最终产物compile默认编译运行都需要√√√√test只用于测试junit√provided编译需要运行时由容器提供servlet-api√√runtime运行时需要编译不需要jdbc 驱动√√system本地 JAR不推荐√√√√3.4 生命周期Lifecycle — 构建的标准化流程Maven 有三套生命周期最常用的是 defaultdefault 生命周期核心阶段从前往后执行validate → compile → test → package → verify → install → deploy常用命令对应阶段mvn compile → 执行到 compilemvn package → 执行到 packagemvn install → 执行到 install3.5 插件Plugin — Maven 的真正执行者Maven 本身只是调度器所有能力来自插件。常用插件生产必备buildplugins!-- 编译插件Java 17 --plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-compiler-plugin/artifactIdversion3.13.0/versionconfigurationsource${java.version}/sourcetarget${java.version}/target/configuration/plugin!-- Spring Boot 打包插件 --plugingroupIdorg.springframework.boot/groupIdartifactIdspring-boot-maven-plugin/artifactId/plugin!-- 跳过测试 --plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-surefire-plugin/artifactIdconfigurationskipTeststrue/skipTests/configuration/plugin/plugins/build4. 多模块项目企业级必备典型结构parent-project (pom) ├── pom.xml ├── common-module ├── service-module ├── web-module └── aggregator (可选)父 pom 最佳实践使用dependencyManagement统一版本使用pluginManagement统一插件配置子模块只dependency不写版本5. 生产级最佳实践2025-2026版本管理统一放在父 pom 的 properties dependencyManagement不要 SNAPSHOT 进私服除非开发阶段依赖尽量显式声明避免依赖传递带来的不确定性常用插件组合compiler / surefire / jar / spring-boot / docker / sonar / jacoco私服Nexus / Artifactory / Archiva常用属性maven.compiler.source17/maven.compiler.sourcemaven.compiler.target17/maven.compiler.targetproject.build.sourceEncodingUTF-8/project.build.sourceEncoding加速-T 1C并行构建、阿里云镜像、梯度缓存6. 学习进阶路线建议阶段目标重点练习1-2 周入门安装 创建项目 依赖引入 打包运行2-4 周中级多模块 依赖范围 生命周期理解 常用插件1-2 月高级自定义插件 私服搭建 父 pom 治理 archetype持续精通依赖冲突分析 enforcer 插件规范 CI/CD 集成有任何具体问题比如依赖冲突怎么排、如何写自定义插件、Spring Boot 与 Maven 的最佳配合、如何做分环境配置等欢迎直接问我可以带你一步步实战