Maven 使用配置详解

原创 已于 2025-11-03 22:45:32 修改 · 1k 阅读 · 9 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#maven #java

于 2025-09-29 12:22:28 首次发布

一、pom.xml 项目配置详解

pom.xml 是 Maven 项目的核心配置文件，主要内容如下：

1. 项目基本信息

<project xmlns="http://maven.apache.org/POM/4.0.0" ...>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging> <!-- jar/war/pom -->
    <name>Demo Project</name>
    <description>这是一个示例项目</description>
  • groupId：组织唯一标识（如公司域名倒写）
  • artifactId：项目唯一标识
  • version：项目版本
  • packaging：打包类型（常用 jar/war）

2. 依赖管理

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>3.0.0</version>
    </dependency>
    <!-- 更多依赖 -->
</dependencies>
  • scope 可选，常见值：compile（默认）、test、provided、runtime

3. 插件配置

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
            </configuration>
        </plugin>
        <!-- 更多插件 -->
    </plugins>
</build>

常见插件有：maven-compiler-plugin（编译）、maven-surefire-plugin（测试）、maven-jar-plugin（打包）等。

4. 资源配置

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
            </includes>
        </resource>
    </resources>
</build>

5. 依赖管理（dependencyManagement）

用于统一管理依赖版本，子模块继承后可不写版本号。

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.30</version>
        </dependency>
    </dependencies>
</dependencyManagement>

6. 仓库配置

<repositories>
    <repository>
        <id>aliyun</id>
        <url>https://maven.aliyun.com/nexus/content/groups/public/</url>
    </repository>
</repositories>

7. Profiles（多环境配置）

<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <env>development</env>
        </properties>
    </profile>
    <profile>
        <id>prod</id>
        <properties>
            <env>production</env>
        </properties>
    </profile>
</profiles>

二、settings.xml 全局/用户级配置详解

settings.xml 一般位于：

  • 全局：MAVEN_HOME/conf/settings.xml
  • 用户：~/.m2/settings.xml

常用配置如下：

1. 本地仓库

<localRepository>/your/path/to/repo</localRepository>

2. 镜像配置（加速依赖下载）

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>central</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

3. 代理设置

<proxies>
    <proxy>
        <id>example-proxy</id>
        <active>true</active>
        <protocol>http</protocol>
        <host>proxy.example.com</host>
        <port>8080</port>
        <username>user</username>
        <password>password</password>
    </proxy>
</proxies>

4. 认证信息（私服账号）

<servers>
    <server>
        <id>my-nexus</id>
        <username>admin</username>
        <password>admin123</password>
    </server>
</servers>

5. profile 激活

<profiles>
    <profile>
        <id>jdk-1.8</id>
        <activation>
            <activeByDefault>true</activeByDefault>
            <jdk>1.8</jdk>
        </activation>
        <properties>
            <maven.compiler.source>1.8</maven.compiler.source>
            <maven.compiler.target>1.8</maven.compiler.target>
        </properties>
    </profile>
</profiles>

三、常见配置示例

1. 常用 pom.xml 示例

<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0.0</version>
    <dependencies>
        <!-- 依赖 -->
    </dependencies>
    <build>
        <plugins>
            <!-- 插件 -->
        </plugins>
    </build>
</project>

2. 常用 settings.xml 示例（配置阿里云镜像）

<settings>
    <mirrors>
        <mirror>
            <id>aliyunmaven</id>
            <mirrorOf>central</mirrorOf>
            <name>阿里云公共仓库</name>
            <url>https://maven.aliyun.com/repository/public</url>
        </mirror>
    </mirrors>
</settings>

四、配置建议

  1. 依赖统一管理：建议用 dependencyManagement 管理依赖版本。
  2. 多环境支持：用 profiles 做环境切换。
  3. 私服/镜像加速：用 settings.xml 配置镜像和私服认证。
  4. 插件版本锁定：指定插件版本，避免构建不一致。

五、项目pom.xml文件详解

1. 基本结构

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    
    <!-- 基本项目信息 -->
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>
    <name>Demo Project</name>
    <description>这是一个示例项目</description>
    <url>http://www.example.com/demo</url>
    
    <!-- 依赖项 -->
    <dependencies>
        <!-- 依赖列表 -->
    </dependencies>
    
    <!-- 构建相关配置 -->
    <build>
        <!-- 插件、资源等 -->
    </build>
    
    <!-- 仓库配置 -->
    <repositories>
        <!-- 远程仓库列表 -->
    </repositories>
    
    <!-- 插件仓库配置 -->
    <pluginRepositories>
        <!-- 插件仓库列表 -->
    </pluginRepositories>
    
    <!-- 依赖管理 -->
    <dependencyManagement>
        <!-- 统一依赖版本管理 -->
    </dependencyManagement>
    
    <!-- 多环境配置 -->
    <profiles>
        <!-- 不同环境的配置 -->
    </profiles>
    
    <!-- 项目开发者信息 -->
    <developers>
        <!-- 开发者列表 -->
    </developers>
    
    <!-- 许可证信息 -->
    <licenses>
        <!-- 许可证列表 -->
    </licenses>
    
    <!-- SCM（代码管理）信息 -->
    <scm>
        <!-- 代码仓库信息 -->
    </scm>
    
    <!-- 其他扩展信息 -->
</project>

2. 重点部分详解

2.1 基本项目信息

  • <groupId>：项目所属组织或公司（通常为域名倒写，如 com.example）
  • <artifactId>：项目名称（唯一标识）
  • <version>：项目版本号
  • <packaging>：打包类型（jar、war、pom等，默认 jar）
  • <name>：项目名称
  • <description>：项目描述
  • <url>：项目主页

2.2 依赖管理（dependencies）

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>3.0.0</version>
        <scope>compile</scope> <!-- 依赖范围，默认 compile -->
        <optional>false</optional> <!-- 是否为可选依赖 -->
    </dependency>
    <!-- 更多依赖 -->
</dependencies>
  • scope：依赖的作用域。常见值有：
    • compile（默认）：编译和运行都需要
    • test：仅测试时需要
    • provided：编译时需要，运行时由容器提供
    • runtime：运行时需要

2.3 构建配置（build）

<build>
    <!-- 资源配置 -->
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
            </includes>
        </resource>
    </resources>
    <!-- 插件配置 -->
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
            </configuration>
        </plugin>
        <!-- 更多插件 -->
    </plugins>
</build>
  • resources：定义资源文件路径和包含/排除规则
  • plugins：定义构建和打包所需的插件及其配置

2.4 仓库配置（repositories）

<repositories>
    <repository>
        <id>aliyun</id>
        <name>阿里云Maven仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </repository>
</repositories>
  • 用于指定额外的依赖下载源

2.5 插件仓库（pluginRepositories）

<pluginRepositories>
    <pluginRepository>
        <id>central</id>
        <url>https://repo.maven.apache.org/maven2</url>
    </pluginRepository>
</pluginRepositories>
  • 用于下载 Maven 插件的仓库

2.6 依赖管理（dependencyManagement）

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.7.30</version>
        </dependency>
    </dependencies>
</dependencyManagement>
  • 用于统一管理依赖版本，子模块引用时无需指定版本

2.7 多环境配置（profiles）

<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <env>development</env>
        </properties>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
    </profile>
    <profile>
        <id>prod</id>
        <properties>
            <env>production</env>
        </properties>
    </profile>
</profiles>
  • 用于定义不同环境下的构建参数、依赖等

2.8 开发者信息（developers）

<developers>
    <developer>
        <id>zhangsan</id>
        <name>张三</name>
        <email>zhangsan@example.com</email>
        <roles>
            <role>开发</role>
            <role>架构师</role>
        </roles>
    </developer>
</developers>

2.9 许可证信息（licenses）

<licenses>
    <license>
        <name>Apache License 2.0</name>
        <url>http://www.apache.org/licenses/LICENSE-2.0</url>
        <distribution>repo</distribution>
    </license>
</licenses>

2.10 代码管理信息（scm）

<scm>
    <connection>scm:git:https://github.com/example/demo.git</connection>
    <developerConnection>scm:git:https://github.com/example/demo.git</developerConnection>
    <url>https://github.com/example/demo</url>
</scm>

3. 简单示例

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>demo</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13.2</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

4. 其他常用标签

  • <properties>：定义自定义属性，可以在其他地方引用 ${propertyName}。
  • <parent>：用于继承父 POM（常见于多模块项目）。
  • <modules>：定义子模块（用于聚合项目）。

5. 总结

pom.xml 是 Maven 项目的核心配置文件，涵盖了项目的所有元数据、依赖、构建流程和扩展信息。
如果你有某个标签或某种配置想深入了解，请具体说明，我可以详细为你解析！

六、maven idea 配置使用

1、安装 IntelliJ IDEA

首先确保你已经安装了 IntelliJ IDEA（推荐使用 Community 或 Ultimate 版本）。

2、安装 Maven

一般来说，IntelliJ IDEA 自带了 Maven 集成，无需单独安装。如果你有特殊需求，也可以去 Maven 官网 下载并安装。

3、创建 Maven 项目

  1. 打开 IntelliJ IDEA，点击 File → New → Project。
  2. 在左侧选择 Maven，然后点击 Next。
  3. 填写 GroupId、ArtifactId 等信息，点击 Next。
  4. 选择项目保存位置，点击 Finish。

IDEA 会自动帮你生成一个包含 pom.xml 的标准 Maven 项目结构。

4、配置 Maven

4.1. 设置 Maven 本地仓库（可选）

如果你想使用自定义的本地仓库：

  • 打开 File → Settings → Build, Execution, Deployment → Build Tools → Maven
  • 在 Local repository 处设置你想要的路径。

4.2. 配置 Maven JDK

  • 在 Maven 配置页面选择合适的 JDK（建议使用 1.8 及以上）。

4.3. 配置 Maven 环境变量（可选）

如果你本地安装了 Maven，可以设置 MAVEN_HOME 环境变量，指向 Maven 安装目录。

5、使用 Maven

5.1. 添加依赖

在 pom.xml 中添加你需要的依赖。例如：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>3.0.0</version>
    </dependency>
</dependencies>

5.2. 构建和运行

  • 右键项目，选择 Run ‘mvn install’ 或使用顶部菜单的 Build → Build Project。
  • 也可以在右侧的 Maven 面板里点击对应的生命周期命令（clean、install、package、compile 等）。

5.3. 更新依赖

  • 右键 pom.xml，选择 Maven → Reload Project，或者点击右侧 Maven 工具栏的刷新按钮。

6、常见问题

  1. 依赖下载慢/失败？

    • 可在 settings.xml 配置国内镜像（如阿里云）。

  2. 项目结构不对？

    • 右键项目，选择 Add Framework Support → Maven。

  3. IDEA 没有识别 Maven 项目？

    • 右键 pom.xml，选择 Add as Maven Project。

7、常用 Maven 命令

  • mvn clean：清理项目
  • mvn compile：编译项目
  • mvn package：打包项目
  • mvn install：安装到本地仓库

总结

IntelliJ IDEA 对 Maven 支持非常好，基本上只要创建 Maven 项目，IDEA 会自动帮你管理依赖和构建。如果有特殊配置需求，可以在设置里进行调整。

Maven使用镜像加速+Maven使用JDK1.8编译
我能在河边钓一整天的鱼
05-12 382
<mirror> <id>alimaven</id> <name>aliyun maven</name> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> <mirrorOf>central</mirrorOf> </mirror&...
Maven全局配置
别再捏我脸了的博客
09-29 1158
IDE中找不到other Settings 全局配置Maven的方法(一次性配置Maven) 最近在用idea写代码的时候发现，每次打开一个新的项目，都需要重新配置一次Maven，特别麻烦。在网上百度很多idea一次性配置Maven的方法。 发现都是File-->other Settings 但是我在我的idea中没有找到other Settings 于是我又开始百度idea中没有other Settings选项的解决办法。有人说是File-->Settings-->other Set
【java】【maven】【基础】MAVEN安装配置介绍
热门推荐
春天的波菜
08-03 1万+
Apache Maven是一个(特别是Java编程)项目管理及自动构建工具，由Apache软件基金会所提供。基于项目对象模型(缩写:POM)概念，Maven利用一个中央信息片断能管理一个项目的构建、报告和文档等步骤。本文是学习MAVEN的启蒙。
maven settings配置详解
11-24
maven的setting配置文件详解。。。。
Maven deploy配置方法详解
08-18
Maven deploy 配置方法详解 Maven deploy 是 Maven 生命周期的一部分，负责将项目的构件部署到远程仓库中，以便其他开发者和工程共享。下面将详细介绍 Maven deploy 配置方法。 pom.xml 配置 在 pom.xml 文件中，...
Maven pom 配置详解
12-22
**Maven POM配置详解** POM（Project Object Model）是Apache Maven的核心概念，它是一个项目对象模型，用于描述一个Maven项目的所有相关信息。POM是通过XML格式编写的，并且通常命名为`pom.xml`，位于项目根目录下...
Spring Boot Maven插件使用详解
08-28
Spring Boot Maven 插件使用详解 Spring Boot Maven 插件是一个功能强大的插件，旨在简化 Spring Boot 应用程序的构建和部署过程。该插件提供了多种功能，包括重新打包、运行、启动和停止等。 重新打包 ----------...
Eclipse中maven的配置详解
08-25
在Eclipse中配置Maven是开发Java项目时必不可少的步骤，因为Maven作为一个强大的构建工具，可以帮助开发者管理和构建项目，依赖管理、构建生命周期以及插件系统都是其核心功能。下面我们将详细讲解如何在Eclipse中...
maven setting配置文件
08-11
maven setting配置文件
maven配置全局的jdk和配置局部的jdk
08-19
maven配置全局的jdk和配置局部的jdk
配置Maven环境（全局）
m0_60946919的博客
07-02 503
3.红框的内容根据自己maven的安装路径选择，依次是maven的安装目录、maven的配置文件、maven本地仓库的地址。2.点击All settings。5.配置项目中字节码的版本。4.确认JRE的版本。
【实用版】Maven中的配置文件
学不会就接着学
09-25 7030
在使用进行项目管理时，合理配置文件可以显著提高开发效率。
Maven的安装和环境变量配置、IDEA的Maven全局设置【每一步都很详细】
qq_56947957的博客
12-05 1645
打开D:\Monkey\apache-maven-3.6.3\conf下的settings.xml【然后、在命令行中输入：mvn -version，看到maven的版本号则。1、右键点击此电脑选择属性，点击高级系统设置，点击环境变量。点进去后新建一个即可。输入%MAVEN_HOME%\bin。2、下载后解压产生此文件（因为我之前下载过）其次配置换成自己的即可，点击应用完成。换成你自己的本地仓库即可。然后再Path上面点击。进行maven的下载。
idea配置Maven环境(全局)
最新发布
m0_63321393的博客
07-06 1241
看到这种图标，表示idea已经把这个项目识别为maven项目。打开pom.xml，下面就是项目的坐标。创建完成后，等待加载完成。
Maven配置教程
coding_1994的博客
11-20 868
Maven配置 Maven项目对象模型(POM)，可以通过一小段描述信息来管理项目的构建，报告和文档的软件项目管理工具。 Maven 的配置却让一些初学者望而却步，这里我就把Maven的详细配置过程写下，希望能对你有所帮助。 文章目录 Maven配置 Maven的下载 Maven常用配置 1. 环境变量配置 2. 修改配置文件 1. 本地仓库位置修改 2. 修改maven默认的JDK版本 3....
配置Maven环境(全局)
2402_84971234的博客
05-26 549
本文介绍了Java项目的配置流程：首先按照1.1节的步骤进行基础配置；然后在1.2节创建空项目，当界面出现特定提示即表示配置成功；最后在1.3节完成JDK版本的配置。整个配置过程分为环境设置、项目创建和JDK版本确认三个关键环节。
Maven 3.2.1配置详解与使用指南
用户可以通过配置和使用插件来扩展Maven的功能，例如使用`maven-compiler-plugin`来编译代码，`maven-jar-plugin`来生成JAR包，以及`maven-dependency-plugin`来进行依赖的分析和操作。学习如何查询Maven中央仓库中...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

猩火燎猿

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值