Maven settings.xml中如何通过activeProfiles和activeProfile激活指定环境ID

Maven的profile机制允许我们为不同的环境定义不同的配置，而激活profile的方式有多种，其中在settings.xml中通过activeProfiles和activeProfile配置是最常用的全局激活方式，能够直接指定需要生效的环境ID。

activeProfiles和activeProfile的作用

activeProfiles是settings.xml中的一个顶层配置标签，用于包裹所有需要全局激活的profile ID，而activeProfile是activeProfiles的子标签，每个activeProfile对应一个需要激活的profile的唯一标识ID。通过这两个标签的配置，Maven在构建时会自动加载对应ID的profile中的配置，无需在命令行额外指定参数。

基础配置格式

在settings.xml中，这两个标签的配置位置是在<settings>根标签下，和<profiles>标签同级，基本结构如下：

<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">
  
  <!-- 其他配置 -->
  
  <activeProfiles>
    <!-- 激活ID为dev的profile -->
    <activeProfile>dev</activeProfile>
    <!-- 可以同时激活多个profile -->
    <activeProfile>test</activeProfile>
  </activeProfiles>
</settings>

配置注意事项

• ID必须匹配：activeProfile中填写的内容必须和profile定义时的<id>标签内容完全一致，包括大小写，否则无法激活对应的profile。
• 多profile激活顺序：如果同时激活多个profile，配置的先后顺序会影响配置的加载优先级，后面激活的profile会覆盖前面同名的配置项。
• 全局生效特性：在settings.xml中配置的activeProfiles是全局生效的，会对所有使用该settings.xml的Maven项目生效，如果需要针对单个项目激活profile，建议在项目的pom.xml中配置。

结合profile定义的完整示例

首先我们在settings.xml中定义两个不同环境的profile，然后在activeProfiles中激活其中一个：

<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">
  
  <profiles>
    <!-- 开发环境profile -->
    <profile>
      <id>dev</id>
      <properties>
        <env.url>http://127.0.0.1:8080</env.url>
        <env.name>开发环境</env.name>
      </properties>
    </profile>
    
    <!-- 生产环境profile -->
    <profile>
      <id>prod</id>
      <properties>
        <env.url>http://ipipp.com</env.url>
        <env.name>生产环境</env.name>
      </properties>
    </profile>
  </profiles>
  
  <activeProfiles>
    <!-- 激活开发环境profile -->
    <activeProfile>dev</activeProfile>
  </activeProfiles>
</settings>

配置完成后，我们执行Maven命令时，就可以直接使用${env.url}和${env.name}这两个属性，它们会自动读取dev环境profile中定义的值。如果要切换到生产环境，只需要把activeProfile的内容改为prod即可。

验证激活结果

我们可以通过Maven命令查看当前生效的profile，验证配置是否生效：

mvn help:active-profiles

如果配置正确，命令执行后会输出当前激活的profile列表，其中包含我们配置的dev，说明环境ID激活成功。

Mavensettings.xmlactiveProfilesactiveProfile环境激活修改时间：2026-07-11 02:15:29