maven配置详解

我会带着你远行 2024-04-01 10:12 37阅读 0赞

下载地址：[Maven – Download Apache Maven][Maven _ Download Apache Maven]，

![27d0b11bb27e008186fcd0051687c983.png][]

添加环境变量：MAVEN\_HOME

一、配置文件

maven的配置文件主要有 settings.xml 和pom.xml 两个文件。

1.其中在maven安装目录，例如apache-maven-3.8.1\\conf目录下的settings.xml 文件是全局配置文件

2.用户目录的.m2子目录下面的settings.xml的配置只是针对当前用户的配置

3.项目根路径下的pom.xml主要是对当前项目的配置。

**局部配置优先于全局配置**。 配置优先级从高到低：pom.xml> user settings > global settings

二、settings.xml 配置详解

1.LocalRepository 本地仓库配置：

<localRepository>D:\repository</localRepository>

2.InteractiveMode 用户输入配置：

3.离线模式

<offline>false</offline>

3.插件组，当我们使用某个插件，并且没有在命令行为其提供组织Id（groupId）的时候，Maven就会使用该列表。默认情况下该列表包含了`org.apache.maven.plugins`和`org.codehaus.mojo`

<pluginGroups>
        <pluginGroup>org.sonarsource.scanner.maven</pluginGroup>
    </pluginGroups>

4.私服服务器配置，配置私服的用户名和密码。配置的私服服务器可以用来发布jar包，与pom.xml 中 发布标签distributionManagement 中配置的仓库ID相互对应。

<servers>
        <server>
            <id>maven-releases</id>
            <username>developer</username>
            <password>123456</password>
            
            <filePermissions>664</filePermissions>
            
            <directoryPermissions>775</directoryPermissions>
        </server>
    </servers>

5.镜像配置

<mirror>
        <id>alimaven</id>
        <name>aliyun maven</name>
        <url>https://maven.aliyun.com/repository/central</url>
        
        <mirrorOf>*</mirrorOf>
    </mirror>

6.Profiles配置。

settings.xml中的profile元素是pom.xml中profile元素的子集。只包含了id、activation、repositories、pluginRepositories和 properties元素。  
如果一个settings.xml中的profile被激活，它的值会覆盖任何其它定义在pom.xml中带有相同id的profile。

<profiles>
        <profile>
            <id>nexus</id>
            
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <repositories>
                
                <repository>
                    <id>nexus</id>
                    <name>gwm nexus</name>
                    <url>http://nexus.maven.cn/repository/maven-public/</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
            </repositories>
            
            <pluginRepositories>
                <pluginRepository>
                    <id>nexus</id>
                    <name>gwm nexus</name>
                    <url>http://nexus.maven.cn/repository/maven-public/</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </pluginRepository>
            </pluginRepositories>
        </profile>
        <profile>
            <id>sonar</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            
            <properties>
                <sonar.host.url>
                    http://localhost:9000
                </sonar.host.url>
                <sonar.login>admin</sonar.login>
                <sonar.password>admin</sonar.password>
            </properties>
        </profile>
    </profiles>

7. Activation配置，用来设置profile配置激活的条件逻辑。

<activation>
      
      <activeByDefault>false</activeByDefault>
      
      <jdk>1.8</jdk>
      
      
      <property>
        
        <name>mavenVersion</name>
        
        <value>2.0.3</value>
      </property>
      
      <file>
        
        <exists>${basedir}/file2.properties</exists>
        
        <missing>${basedir}/file1.properties</missing>
      </file>
    </activation>

8.properties 配置，对应`profile`的扩展属性和pom中properties的属性列表，这些值可以在`pom.xml，setting.xml`中使用标记`${X}`来使用，这里X是指属性的名称。

<properties>

<project.version>1.0</project.version>

</properties>

9. Repositories 远程仓库配置，可以配置多个。可以配置在<settings>标签中，也可以配置在<profile>标签中（比较常见，配置在<profile>标签中可以根据profile的激活情况动态选择仓库）。配置形式参见《6.Profiles配置》。

10.插件仓库pluginRepositories 和repositories相同。

11. 激活profile配置 activeProfiles，用来激活配置的profile。和 activation 配置相比 activeProfiles 配置比较简单，也比较常用。

<activeProfiles>
            <activeProfile>nexus</activeProfile>
        </activeProfiles>

三、POM.xml配置文件：

<parent>
        
        <artifactId />
        
        <groupId />
        
        <version />
        
        <relativePath>../pom.xml</relativePath>
    </parent>
    
    
    <modelVersion>4.0.0</modelVersion>
    
    <groupId>com.companyname.project-group</groupId>
    
    <version>1.0</version>
    
    
    <packaging>jar</packaging>
    
    
    <properties>
        
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
        <spring-boot.version>2.3.7.RELEASE</spring-boot.version>
    </properties>
    
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
            <version>${spring-boot.version}</version>
            <scope>compile</scope>
        </dependency>
    </dependencies>
    
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>cn.hutool</groupId>
                <artifactId>hutool-core</artifactId>
                <version>${hutool.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>     
    
    
    <build>
        
        <pluginManagement>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                    <version>${spring-boot.version}</version>
                </plugin>
            </plugins>
        </pluginManagement>
        
        <plugins>
            <plugin>
                <groupId>org.sonarsource.scanner.maven</groupId>
                <artifactId>sonar-maven-plugin</artifactId>
                <version>3.6.0.1398</version>
            </plugin>
        </plugins>
    </build>       
    
    
    <repositories>
        <repository>
            <id>aliyun-public</id>
            <url>https://maven.aliyun.com/repository/public</url>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
            <releases>
                <enabled>true</enabled>
            </releases>
        </repository>
    </repositories>
    
    <pluginRepositories>
        <pluginRepository>
            <id>aliyun-public</id>
            <url>https://maven.aliyun.com/repository/public</url>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
            <releases>
                <enabled>true</enabled>
            </releases>
        </pluginRepository>
    </pluginRepositories>
    
    
    <distributionManagement>
        <repository>
            
            <id>maven-releases</id>
            <name>releases</name>
            <url>http://nexus.maven.cn/repository/maven-releases/</url>
            <uniqueVersion>true</uniqueVersion>
        </repository>
        <snapshotRepository>
            <id>maven-snapshots</id>
            <name>snapshots</name>
            <url>http://nexus.maven.cn/repository/maven-snapshots/</url>
        </snapshotRepository>
    </distributionManagement>
    
    
    <profiles>
        <profile>
            <id>dev</id>
            <properties>
                <spring.profiles.active>dev</spring.profiles.active>
            </properties>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
        </profile>
        <profile>
            <id>prod</id>
            <properties>
                <spring.profiles.active>prod</spring.profiles.active>
            </properties>
        </profile>
    </profiles>

四、远程仓库的加载

maven仓库依赖下载顺序：

1，在settings.xml文件中配置的本地仓库中寻找依赖，没找到则进入第2步。

2，在settings.xml文件中配置的全局远程仓库中寻找，没找到则进入第3步。

3，在当前项目的pom.xml中配置的远程仓库中寻找，如果没找到则进入第4步。

4，在中央仓库 https://repo.maven.apache.org/maven2 中寻找，如果没找到则抛出依赖无法加载异常。

镜像替换：

1，如果在找寻的过程中，如果发现该仓库有镜像匹配，则直接从镜像仓库中加载。

2，如果仓库的 id 设置成 <mirrorOf>central</mirrorOf>，则会覆盖 maven 的中央仓库配置。

3，如果镜像 ID 设置为 <mirrorOf>\*</mirrorOf> 表示匹配所有的仓库，则所有依赖只从此镜像仓库中下载。

4，如果镜像ID 设置为 <mirrorOf>repo1,repo2</mirrorOf>，则匹配仓库repo1和repo2，使用逗号分隔多个远程仓库

5，如果镜像ID设置为 <mirrorOf>\*,!repo1</miiroOf>匹配所有远程仓库，repo1除外，使用感叹号将仓库从匹配中排除

建议将镜像地址作为一个 普通仓库repository 进行配置，这样可以在其他 仓库下载不了的情况下查找到此仓库。如果配置了镜像仓库代替其他仓库容易出现在镜像中找不到依赖，导致项目无法编译的问题。

**原创文章，引用请注明出处，并联系本人征得本人同意后才可转载。**

[Maven _ Download Apache Maven]: http://maven.apache.org/download.cgi
[27d0b11bb27e008186fcd0051687c983.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/195c8eda197744e8bb2f25ca9ccdf150.png