# Maven 配置文件 > For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt). IntelliJ IDEA 允许您使用 [Maven build profiles](http://maven.apache.org/guides/introduction/introduction-to-profiles.html),这可以帮助您为特定环境(例如生产环境或开发环境)定制构建。 您还可以定义多个运行/调试配置,每个配置包含特定的配置文件,以便更轻松地执行。 ## 声明 Maven 配置文件 IntelliJ IDEA 允许您在项目的 POM 中明确声明配置文件。 使用代码补全功能,您可以在 `profiles` 标签中放置多种不同的配置,并覆盖在您 POM 中指定的默认配置,如 Maven 插件、依赖、仓库等。 Procedure: 1. 在编辑器中打开您的 POM。 2. 请指定 `<配置文件>` 部分并声明配置文件。 ![配置声明](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_profile_declaration.png) IntelliJ IDEA 在 配置文件 列表中显示它们,该列表位于 Maven 工具窗口中。 ![Maven 工具窗口](https://resources.jetbrains.com.cn/help/img/idea/2026.3/settings.xml` 。 * 您可以在项目基础目录(profiles.xml)中的配置描述符中定义它们。 请注意,此选项在 Maven 3 中不受支持。 请参阅 [Maven 3 兼容性说明](https://cwiki.apache.org/confluence/display/MAVEN/Maven+3.x+Compatibility+Notes)。 ## 激活 Maven 配置文件 您可以在 Maven 工具窗口中使用 配置文件 节点和相应配置文件的复选框激活配置文件。 Procedure: 激活 Maven 配置文件 1. 打开 [Maven](maven-projects-tool-window.html) 工具窗口。 2. 点击 配置文件 节点以打开声明的配置文件列表。 3. 请选择适当的复选框以激活您需要的配置文件。 您可以拥有多个活动配置文件。 当它们被激活时,它们的配置将根据 POM 配置文件声明进行合并。 您还可以根据一系列上下文条件自动激活配置文件。 例如,JDK 版本、操作系统名称和版本、特定文件或属性的存在或不存在,但您仍需要在 POM 中指定所有参数。 > **Note:** > 如果您使用带有 JDK 条件的配置文件激活(POM 中的 JDK 标签: `` ),IntelliJ IDEA 将在同步项目和解析依赖项时使用 [Maven 导入器的 JDK 版本](maven-support.html#maven_importer),而不是项目的 JDK 版本。 此外,若您使用 `https` 证书,您需要为 Maven 导入程序 以及 Maven 运行程序 手动包含它们。 您可以在 POM 中使用 `activeByDefault` 标记声明一个 Maven 配置文件,该配置文件仅在 Maven 没有找到任何其他活动配置文件时激活。 如需更多信息,请参阅 [Maven profiles](https://maven.apache.org/guides/introduction/introduction-to-profiles.html)。 > **Note:** > 每次更改 `pom.xml` 文件时,请记得同步以在 Maven 工具窗口中查看更改。 当 `pom.xml` 更改时,会显示一个弹出窗口建议导入更改。 您还可以点击 ![重新加载所有 Maven 项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.refresh.svg) 工具窗口的工具栏中的 Maven 。 ![POM:配置文件激活](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_profiles_pom.png) IntelliJ IDEA 在 `activeByDefault` 工具窗口中显示 Maven 配置文件,所选的复选框是灰色的。 ![Maven 工具窗口:选定的配置文件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_proj_tool_win_profiles.png) 您可以通过点击复选框手动停用此配置文件。 另请注意,如果您手动激活任何其他配置文件, `activeByDefault` 配置文件将被停用。 ![Maven 工具窗口:停用配置文件](https://resources.jetbrains.com.cn/help/img/idea/2026.3/maven_tool_win_deactivate_profile.png) 当您处理多模块项目时,请记住,如果您在 POM 中指定了 `activeByDefault` 配置文件,那么即使它是在不同模块的 POM 中声明的,当您手动激活任何其他配置文件时,它也会被停用。 如果您需要停用配置文件,请按照以下步骤操作: Procedure: 停用 Maven 配置文件 1. 打开 [Maven](maven-projects-tool-window.html) 工具窗口。 2. 点击 配置文件 节点以打开声明的配置文件列表。 3. 清除适当的复选框以停用您需要的配置文件。 这将阻止 IntelliJ IDEA 在构建或运行 Maven 命令时使用这些配置文件。 如果您想永久删除声明的配置文件,请使用 `pom.xml` 文件,找到 `<配置文件>` 部分,并删除所需的配置文件定义。 Procedure: 在运行/调试配置中指定 Maven 配置文件 1. 在 Maven 工具窗口中,右键点击要为其配置运行/调试配置的目标。 2. 在上下文菜单中,选择 修改运行配置 。 > **Note:** > 或者,从主菜单中选择 添加配置 。 3. 在打开的对话框中,在 配置文件 字段中,指定所需的配置文件,并点击 确定 以保存更改。 创建的配置将添加到 运行配置 节点。