Maven配置文件及命令说明(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 官方文档。