Maven配置文件及命令说明

Maven 是一个流行的 Java 项目构建和依赖管理工具，其核心配置文件是 pom.xml（Project Object Model）。除此之外，Maven 还有一些其他配置文件（如 settings.xml）。以下是主要文件的说明：

1. pom.xml 文件

作用：定义项目的基本信息、依赖、构建配置等。
路径：位于项目根目录下。

关键配置项：

xml

<project>

<!-- 基础信息 -->

<modelVersion>4.0.0</modelVersion> <!-- POM 模型版本 -->

<groupId>com.example</groupId> <!-- 组织/公司标识 -->

<artifactId>my-app</artifactId> <!-- 项目标识 -->

<version>1.0.0</version> <!-- 项目版本 -->

<!-- 依赖管理 -->

<dependencies>

<dependency>

<groupId>junit</groupId>

<artifactId>junit</artifactId>

<version>4.12</version>

<scope>test</scope> <!-- 依赖范围（compile/test/provided等） -->

</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> <!-- 指定 JDK 版本 -->

<target>1.8</target>

</configuration>

</plugin>

</plugins>

<!-- 资源文件配置 -->

<resources>

<resource>

<directory>src/main/resources</directory>

<filtering>true</filtering> <!-- 是否启用变量替换 -->

</resource>

</resources>

</build>

<!-- 多模块项目 -->

<modules>

<module>sub-module1</module> <!-- 子模块路径 -->

</modules>

<!-- 父项目继承 -->

<parent>

<groupId>com.example.parent</groupId>

<artifactId>parent-project</artifactId>

<version>1.0.0</version>

</parent>

</project>

2. settings.xml 文件

作用：配置 Maven 的全局或用户级设置，如仓库地址、代理、镜像等。
路径：

• 全局配置：${Maven安装目录}/conf/settings.xml
• 用户级配置：~/.m2/settings.xml

关键配置项：

xml

<settings>

<!-- 本地仓库路径 -->

<localRepository>/path/to/local/repo</localRepository>

<!-- 镜像仓库 -->

<mirrors>

<mirror>

<id>aliyun-maven</id>

<mirrorOf>*</mirrorOf>

<name>Aliyun Maven Mirror</name>

<url>https://maven.aliyun.com/repository/public</url>

</mirror>

</mirrors>

<!-- 代理设置 -->

<proxies>

<proxy>

<id>my-proxy</id>

<active>true</active>

<protocol>http</protocol>

<host>proxy.example.com</host>

<port>8080</port>

</proxy>

</proxies>

<!-- 服务器认证信息（如私有仓库） -->

<servers>

<server>

<id>nexus</id>

<username>admin</username>

<password>secret</password>

</server>

</servers>

<!-- 配置 Profile（环境） -->

<profiles>

<profile>

<id>dev</id>

<properties>

<env>development</env>

</properties>

<activation>

<activeByDefault>true</activeByDefault> <!-- 默认激活 -->

</activation>

</profile>

</profiles>

</settings>

3. 其他相关文件

• .mvn 目录：存放 Maven 扩展配置（如 maven.config、extensions.xml）。
• mvnw / mvnw.cmd：Maven Wrapper 脚本，用于在不安装 Maven 的情况下运行构建。
• target 目录：构建生成的输出文件（如 JAR、编译后的类文件）。

4. 常见命令

• mvn clean：清理 target 目录。
• mvn compile：编译源代码。
• mvn test：运行单元测试。
• mvn package：打包项目（生成 JAR/WAR）。
• mvn install：将构建结果安装到本地仓库。
• mvn deploy：将构建结果部署到远程仓库。

5. 依赖范围（<scope>）

• compile：默认范围，参与编译、测试、运行。
• test：仅用于测试（如 JUnit）。
• provided：由 JDK 或容器提供（如 Servlet API）。
• runtime：运行时需要，编译时不需要（如 JDBC 驱动）。
• system：需显式指定本地路径（不推荐）。

6. 多模块项目结构

复制

下载

parent-project/

├── pom.xml <!-- 父 POM -->

├── module1/

│ └── pom.xml <!-- 子模块1 -->

└── module2/

└── pom.xml <!-- 子模块2 -->

通过合理配置 pom.xml 和 settings.xml，可以实现依赖管理、构建优化、多环境配置等功能。如果需要进一步了解，可以参考 Maven 官方文档。