Maven配置文件用法及說明(pom.xml和setting.xml)

更新時間：2026年05月30日 14:04:30 作者：tomorrow.hello

Maven設(shè)置倉庫地址及常用命令,包括pom.xml和conf/settings.xml配置方式,mvn?clean、package、install、deploy命令詳解,以及profile、mirrors、servers配置說明

1.pom.xml

1.1 mvn常用的命令

mvn clean package：打包到本項目，一般在項目target目錄下

它執(zhí)行了（7步）： clean、resources、compile、testResources、testCompile、test、jar

mvn clean install：打包到本地倉庫，如果沒設(shè)置Maven本地倉庫，一般在用戶/.m2目錄下。

它執(zhí)行了（8步）：clean、resources、compile、testResources、testCompile、test、jar、install

mvn clean deploy：打包上傳到遠程倉庫，如：私服nexus等，需要配置pom文件

它執(zhí)行了（9步）：clean、resources、compile、testResources、testCompile、test、jar、install、deploy.

例如：

mvn deploy:deploy-file -DgroupId=com.alibaba -DartifactId=fastjson -Dversion=1.1.37 -Dpackaging=jar -Dfile=C://fastjson-1.1.37.jar -Durl=http://localhost:8081/nexus/content/repositories/thirdparty/ -DrepositoryId=thirdparty

1.2 pom.xml設(shè)置倉庫

release和snapshot兩者的區(qū)別。release是穩(wěn)定版本，一經(jīng)發(fā)布不再修改，想發(fā)布修改后的項目，只能升級項目版本再進行發(fā)布；snapshot是不穩(wěn)定的，一個snapshot的版本可以不斷改變。

項目在開發(fā)期間一般會使用snapshot，更方便進行頻繁的代碼更新；一旦發(fā)布到外部，或者開發(fā)基本完成，代碼迭代不再頻繁，則推薦使用release。

<repositories>
    <repository>
        <!--遠程倉庫唯一標(biāo)識符。用來匹配在settings.xml文件中配置的server.id -->
        <id>alimaven</id>
         <!--遠程倉庫名稱 -->
        <name>aliyun maven</name>
        <url>https://maven.aliyun.com/nexus/content/repositories/central/</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
        <!-- 用于定位和排序構(gòu)件的倉庫布局類型?？梢允莇efault或者legacy -->
        <layout>default</layout>
    </repository>
</repositories>
<!--發(fā)現(xiàn)插件的遠程倉庫列表，這些插件用于構(gòu)建和報表 -->
<pluginRepositories>
    <pluginRepository>
        <id>alimaven</id>
        <name>aliyun maven</name>
        <url>https://maven.aliyun.com/nexus/content/repositories/central/</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </pluginRepository>
</pluginRepositories>

1.3 工程發(fā)布到遠程倉庫distributionManagement

 <!--在執(zhí)行mvn deploy后表示要發(fā)布的位置。用于把項目發(fā)布到遠程倉庫 -->
    <distributionManagement>
        <!--部署項目產(chǎn)生的構(gòu)件到遠程倉庫需要的信息 -->
        <repository>
            <!-- 是分配給快照一個唯一的版本號 -->
            <uniqueVersion/>
            <!--遠程倉庫唯一標(biāo)識符。用來匹配在settings.xml文件中配置的server.id -->
            <id>nanxs-maven2</id>
            <name>nanxsmaven2</name>
            <url></url>
        </repository>
        <snapshotRepository>
            <uniqueVersion/>
            <id>nanxs-maven2</id>
            <name>Nanxs-maven2 Snapshot Repository</name>
            <url></url>
        </snapshotRepository>
    </distributionManagement>

1.4 dependency依賴設(shè)置

pom文件中通過dependencyManagement來聲明依賴，通過dependencies元素來管理依賴。

dependencyManagement下的子元素只有一個直接的子元素dependencice，其配置和dependencies子元素是完全一致的；而dependencies下只有一類直接的子元素：dependency。

一個dependency子元素表示一個依賴項目。

  <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>2.7.5</version>
            <!--默認(rèn)是jar,可以是jar，war，ejb-client和test-jar-->
            <type>jar</type>
            <!--依賴的分類器。分類器可以區(qū)分屬于同一個POM，但不同構(gòu)建方式的構(gòu)件。分類器名被附加到文件名的版本號后面，如果想將項目構(gòu)建成兩個單獨的JAR，分別使用Java 4和6編譯器，就可以使用分類器來生成兩個單獨的JAR構(gòu)件-->
            <classifier></classifier>
            <!--控制依賴傳遞，排除該項目中的一些依賴，即本項目A依賴該dependency指示的項目B，但是不依賴項目B中依賴的這些依賴；-->
            <exclusions>
                <exclusion>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-starter-log4j2</artifactId>
                </exclusion>
            </exclusions>
            <!--可選依賴，用于阻斷依賴的傳遞性，即本項目不會依賴父項目中optional設(shè)置為true的依賴。-->
            <optional>true</optional>
            <!-- 依賴范圍:-->
            <!-- - compile：默認(rèn)范圍，用于編譯;-->
            <!-- - provided：類似于編譯，但支持jdk或者容器提供，類似于classpath-->
            <!-- - runtime: 在執(zhí)行時需要使用;-->
            <!-- - systemPath: 僅用于范圍為system，提供相應(yīng)的路徑-->
            <!-- - test: 用于test任務(wù)時使用;-->
            <!-- - system: 需要外在提供相應(yīng)的元素，通過systemPath來取得-->
            <!-- - optional: 當(dāng)項目自身被依賴時，標(biāo)注依賴是否傳遞。用于連續(xù)依賴時使用-->
            <scope>compile</scope>
        </dependency>

1.5 build配置

build配置下主要分為resources，pulgins，還有其他配置（類似finalName）。

<build>
        <!--        其他配置-->
        <!--當(dāng)項目沒有規(guī)定目標(biāo)（Maven2 叫做階段）時的默認(rèn)值 -->
        <defaultGoal></defaultGoal>
        <!--構(gòu)建產(chǎn)生的所有文件存放的目錄 -->
        <directory></directory>
        <!--產(chǎn)生的構(gòu)件的文件名，默認(rèn)值是${artifactId}-${version}。 -->
        <finalName></finalName>
        <!--當(dāng)filtering開關(guān)打開時，使用到的過濾器屬性文件列表 -->
        <filters></filters>
        <!--項目源碼目錄，當(dāng)構(gòu)建項目的時候，構(gòu)建系統(tǒng)會編譯目錄里的源碼。該路徑是相對于pom.xml的相對路徑。 -->
        <sourceDirectory></sourceDirectory>
        <!--該元素設(shè)置了項目單元測試使用的源碼目錄。該路徑是相對于pom.xml的相對路徑 -->
        <testSourceDirectory></testSourceDirectory>
        <!--被編譯過的應(yīng)用程序class文件存放的目錄。 -->
        <outputDirectory></outputDirectory>
        <!--被編譯過的測試class文件存放的目錄。 -->
        <testOutputDirectory></testOutputDirectory>
        <!--項目腳本源碼目錄，該目錄下的內(nèi)容，會直接被拷貝到輸出目錄，因為腳本是被解釋的，而不是被編譯的 -->
        <scriptSourceDirectory></scriptSourceDirectory>
        <!--        resources配置-->
        <resources>
            <!--這個元素描述了項目相關(guān)或測試相關(guān)的所有資源路徑 -->
            <resource>
                <!-- 描述了資源的目標(biāo)輸出路徑。該路徑是相對于target/classes的路徑 -->
                <!-- 如果是想要把資源直接放在target/classes下，不需要配置該元素 -->
                <targetPath>./</targetPath>
                <!--是否使用參數(shù)值代替參數(shù)名。參數(shù)值取自文件里配置的屬性，文件在filters元素里列出 -->
                <filtering/>
                <!--描述打包前的資源存放的目錄，該路徑相對POM路徑 -->
                <directory>./</directory>
                <!--包含的模式列表，例如**/*.xml，只有符合條件的資源文件才會在打包的時候被放入到輸出路徑中 -->
                <includes>./*.html</includes>
                <!--排除的模式列表，例如**/*.xml，符合的資源文件不會在打包的時候會被過濾掉 -->
                <excludes>./*.xml</excludes>
            </resource>
        </resources>
        <!--        plugins配置-->
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

默認(rèn)的plugins：

plugin	funcation	life cycle phase
maven-clean-plugin	清理上一次執(zhí)行創(chuàng)建的目標(biāo)文件	clean
maven-resources-plugin	處理源資源文件和測試資源文件	resources;testResources
maven-compiler-plugin	編譯源文件和測試源文件	compile,testCompile
maven-surefire-plugin	執(zhí)行測試文件	test
maven-jar-plugin	創(chuàng)建jar	jar
maven-install-plugin	安裝jar,將創(chuàng)建生成的jar拷貝到.m2/repository下面	install
maven-deploy-plugin	發(fā)布jar	deploy

1.6 profiles配置

profile是配置動態(tài)激活不同環(huán)境、依賴打包部署。

 <profiles>
        <profile>
            <id>dev</id>
            <activation>
                <!--                設(shè)置默認(rèn)激活：-->
                <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
                <classname>SecurityProgram.class</classname>
            </properties>
            <build>
                <finalName>dev-jar</finalName>
                <plugins>
                    <plugin>
                        <!--                        設(shè)置jar包中只有SecurityProgram.class-->
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-jar-plugin</artifactId>
                        <configuration>
                            <includes>
                                <include>**/${classname}</include>
                            </includes>
                        </configuration>
                    </plugin>
                </plugins>
            </build>
        </profile>
        <profile>
            <id>prod</id>
            <build>
                <finalName>prod-jar</finalName>
                <plugins>
                    <plugin>
                        <groupId>org.springframework.boot</groupId>
                        <artifactId>spring-boot-maven-plugin</artifactId>
                    </plugin>
                </plugins>
            </build>
        </profile>
    </profiles>

命令行執(zhí)行：

編譯：mvn compile -P prod
打包：mvn package -P prod
部署（本地倉庫）：mvn install -P dev
發(fā)布（遠程倉庫）：mvn deploy -P dev
查看當(dāng)前激活的profile：mvn help:active-profiles

參數(shù)說明：

-P [parameter]：-P可以同時多個參數(shù)，如mvn deploy -P test,dev，test和dev都是上面自定義的profile的id值。

2.setting文件

settings.xml文件

settings 主要由mirrors、servers 和profiles 三部分組成。

central從aliyun代理下載

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <!--
    配置本地MAVEN倉庫位置，默認(rèn)在：C:\Users\機器名\.m2\repository
    <localRepository>D:\Program Files\mvn\</localRepository>  
    ** Eclipse->Windows->Preferences->java->Build Path->Classpath Variables 
    -->
     <localRepository>D:\MyTemp\mavenLibTemp</localRepository>  
    <pluginGroups>
    </pluginGroups>
    <proxies>
    </proxies>
  <servers>
		<server>
        <id>nexus-releases</id>
        <username>admin</username> 
        <password>123456</password>
    </server>
    <server>
        <id>nexus-snapshots</id>
        <username>admin</username>
        <password>123456</password>
	  </server>
	  <server>
        <id>mynexus</id>
        <username>admin</username>
        <password>123456</password>
	  </server>
  </servers>
	<!-- 鏡像代理地址,阿里云倉庫，也可以在pom中設(shè)置倉庫地址 -->
    <mirrors>
      <mirror>
        <!-- 鏡像唯一標(biāo)識符 -->
        <id>aliyunmaven</id>
        <!-- 被鏡像的服務(wù)器的id，為哪個repository配置的id做鏡像，central是默認(rèn)的repository:https://repo.maven.apache.org/maven2 -->
        <mirrorOf>central</mirrorOf>
        <name>阿里云公共倉庫</name>
        <!-- 構(gòu)建系統(tǒng)會優(yōu)先考慮使用該URL，而非使用默認(rèn)的服務(wù)器URL -->
        <url>https://maven.aliyun.com/repository/public</url>
      </mirror>
    </mirrors>
    <profiles>
    	<profile>
        <activation>
          <activeByDefault>true</activeByDefault>
        </activation>
        <id>aliyun_mynexus</id>
        <repositories>
          <repository>
            <id>mynexus</id>
            <url>http://192.168.31.240:8081/repository/maven-public/</url>
            <!-- 能下載正式版本 -->
            <releases><enabled>true</enabled></releases>
            <!-- 能下載快照版本 -->
            <snapshots><enabled>true</enabled></snapshots>
          </repository>
        </repositories>
      </profile>
    </profiles>
    <!-- 增加了一個profile，所以只設(shè)置默認(rèn) -->
    <!-- <activeProfiles>
      <activeProfile>aliyun_mynexus</activeProfile>
    </activeProfiles> -->
</settings>

這里看到central的倉庫的地址還沒改變

修改central的地址

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <!--
    配置本地MAVEN倉庫位置，默認(rèn)在：C:\Users\機器名\.m2\repository
    <localRepository>D:\Program Files\mvn\</localRepository>  
    ** Eclipse->Windows->Preferences->java->Build Path->Classpath Variables 
    -->
     <localRepository>D:\MyTemp\mavenLibTemp</localRepository>  
    <pluginGroups>
    </pluginGroups>
    <proxies>
    </proxies>
  <servers>
		<server>
        <id>nexus-releases</id>
        <username>admin</username> 
        <password>123456</password>
    </server>
    <server>
        <id>nexus-snapshots</id>
        <username>admin</username>
        <password>123456</password>
	  </server>
	  <server>
        <id>mynexus</id>
        <username>admin</username>
        <password>123456</password>
	  </server>
  </servers>
	<!-- 鏡像代理地址,阿里云倉庫，也可以在pom中設(shè)置倉庫地址 -->
    <mirrors>
      <mirror>
        <!-- 鏡像唯一標(biāo)識符 -->
        <id>aliyunmaven</id>
        <!-- 被鏡像的服務(wù)器的id，為哪個repository配置的id做鏡像，central是默認(rèn)的repository:https://repo.maven.apache.org/maven2 -->
        <mirrorOf>central</mirrorOf>
        <name>阿里云公共倉庫</name>
        <!-- 構(gòu)建系統(tǒng)會優(yōu)先考慮使用該URL，而非使用默認(rèn)的服務(wù)器URL -->
        <url>https://maven.aliyun.com/repository/public</url>
      </mirror>
    </mirrors>
    <profiles>
    	<profile>
        <activation>
          <activeByDefault>true</activeByDefault>
        </activation>
        <id>aliyun_mynexus</id>
        <repositories>
        <!-- 阿里倉庫使用地址 -->
          <repository>
            <id>central</id>
            <url>https://maven.aliyun.com/repository/central</url>
            <releases>
              <enabled>true</enabled>
            </releases>
            <snapshots>
              <enabled>true</enabled>
            </snapshots>
          </repository>
          <repository>
            <id>mynexus</id>
            <url>http://192.168.31.240:8081/repository/maven-public/</url>
            <!-- 能下載正式版本 -->
            <releases><enabled>true</enabled></releases>
            <!-- 能下載快照版本 -->
            <snapshots><enabled>true</enabled></snapshots>
          </repository>
        </repositories>
      </profile>
    </profiles>
    <!-- 增加了一個profile，所以只設(shè)置默認(rèn) -->
    <!-- <activeProfiles>
      <activeProfile>aliyun_mynexus</activeProfile>
    </activeProfiles> -->
</settings>

這里看到central的地址已經(jīng)改變了

2.1 mirrors

mirrors 主要作用是一個鏡像代理，便于內(nèi)外網(wǎng)廠庫切換，或者單獨配置內(nèi)網(wǎng)使用。

如果pom中的repository的id能和mirrorOf的值關(guān)聯(lián)上，那么url以mirror的為準(zhǔn)，否則以repository中自己的url為準(zhǔn)。

mirrorof：

*代表所有倉庫請求都走這個配置的鏡像代理
central 默認(rèn)是maven 的倉庫

2.2 servers

關(guān)聯(lián)pom中distributionManagement下repository的id，在推送依賴包的時候id進行認(rèn)證和seting.xml的repository進行ID認(rèn)證。

2.3 profiles

多個profile的配置

<?xml version="1.0" encoding="UTF-8"?>
<settings
    xmlns="http://maven.apache.org/SETTINGS/1.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <localRepository>/Users/Documents/repo</localRepository>
    <pluginGroups></pluginGroups>
    <proxies></proxies>
    <servers>
        <!--發(fā)布到倉庫中的配置，id要和distributionrepository(pom.xml中)保持一致
            服務(wù)器要打包上傳到私 服時，設(shè)置私 服的鑒權(quán)信息，否和報錯 Return code is: 401, ReasonPhrase: Unauthorized -->
        <server>
            <id>release</id>
            <username>deployment</username>
            <password>123456</password>
        </server>
        <server>
            <id>snapshot</id>
            <username>deployment</username>
            <password>123456</password>
        </server>
    </servers>
    <mirrors>
        <!--  設(shè)置多個mirrors鏡像，鏡像只會執(zhí)行第一個位置mirror。-->
        <!--  配置的多個mirror可以都放著不影響，選取一個鏡像下載比較快的放在第一個就行。比如你設(shè)置使用自己公司的私有倉庫-->
        <!--只有當(dāng)前一個mirror無法連接的時候，才會去找后一個，類似于備份和容災(zāi)。所以當(dāng)?shù)谝粋€mirror中不存在a.jar的時候，并不會去第二個mirror中查找，甚至于，maven根本不會去其他的mirror地址查詢-->
        <mirror>
            <!--當(dāng)有id為B,A,C的順序的mirror在mirrors節(jié)點中，maven會根據(jù)字母排序來指定第一個，所以不管怎么排列，一定會找到A這個mirror來進行查找，當(dāng)A無法連接，出現(xiàn)意外的情況下，才會去B查詢-->
            <id>aliyun</id>
            <name>aliyun Maven</name>
            <url>>http://maven.aliyun.com/nexus/content/groups/public</url>
            <mirrorOf>*</mirrorOf>
        </mirror>
    </mirrors>
    <!-- maven配置多倉庫。使用順序是倒序的，所以最流暢的寫在最下面。 -->
    <profiles>
        <!-- 阿里云profile -->
        <profile>
            <id>aliyun-Repository</id>
            <!-- 指定當(dāng)前是默認(rèn)的profile -->
            <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>
                <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
            </properties>
            <repositories>
                <repository>
                    <id>aliyun</id>
                    <url>>http://maven.aliyun.com/nexus/content/groups/public</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
            </repositories>
        </profile>
        <profile>
            <!-- suwell profile -->
            <id>suwell-Repository</id>
            <repositories>
                <repository>
                    <id>first</id>
                    <name>Repository first</name>
                    <url></url>
                </repository>
            </repositories>
        </profile>
        <profile>
            <!-- gomain profile -->
            <id>gomain-Repository</id>
            <repositories>
                <repository>
                    <id>second</id>
                    <name>Repository second</name>
                    <url></url>
                </repository>
            </repositories>
        </profile>
    </profiles>
	<!-- 激活倉庫配置，拉取依賴會在這些倉庫中逐個去找 -->
    <activeProfiles>
        <activeProfile>first-Repository</activeProfile>
        <activeProfile>aliyun-Repository</activeProfile>
        <activeProfile>second-Repository</activeProfile>
    </activeProfiles>
</settings>