企业官网建设流程全解析

• 文档
• 教程

本篇指南基于 IntelliJ IDEA 专题教程中「IntelliJ IDEA 配合 Maven 的一些要点」一章展开，系统讲解 Mavenprofile的核心概念、settings.xml中仓库 profile 的三种典型写法、pom.xml中 dev/product 多环境打包配置，以及在 IntelliJ IDEA 的 Maven 面板中勾选启用 profile 的完整操作。读完你可以在 IDEA 中自由切换 Nexus / 阿里云镜像仓库、按环境打包不同配置文件，并借助 Maven 组件面板快速排查依赖冲突。

环境与学习前提

本文的操作示例基于以下环境（来自原文档，版本仅供参考，新版本 IDEA 的操作入口基本一致）：

• IntelliJ IDEA 2017.1
• Maven 3.3.9
• Nexus 3.2.1

学习本文之前需要具备两个前提：

1. 了解 Maven 配置的基本用法——如pom.xml、settings.xml的结构和生命周期命令；
2. 了解私有仓库（如 Nexus）的基本概念——包括maven-public、maven-releases、maven-snapshots等仓库组的含义。

此外，原文档给出了一个非常实用的建议：强烈建议把 Maven 的settings.xml文件同时放在%USER_HOME%/.m2/settings.xml和${maven.home}/conf/settings.xml两个位置。原因是当你在终端（命令行）直接执行 Maven 命令时，Maven 默认读取的是用户目录下的settings.xml，而 IntelliJ IDEA 默认读取的是其配置的 Maven 安装目录下的settings.xml。两份配置不同步会导致「在 IDEA 里能用的仓库配置，在终端里却失效」的诡异问题，双份放置可以从根源上避免这种不一致。

Maven 中的 profile：解决不同环境的配置差异

Maven 中有一个非常重要的概念叫profile，它的诞生主要是为了解决不同环境所需的不同变量、配置等问题：

• 有了 profile，可以根据激活的条件，启动不同条件下的配置信息；
• profile 可以有多个，也可以同时激活多个，方便自由组合（例如同时激活「内网仓库」+「dev 环境」两个 profile）；
• profile 一般可以定义在三个位置：settings.xml、pom.xml、profiles.xml（第三种不常用）；
• 不同位置的 profile 用途不同：settings.xml上的 profile 一般用来做仓库的选择，pom.xml上的 profile 一般用来做环境配置的切换。

在 settings.xml 中用 profile 管理仓库

在settings.xml中，profile 最常见的用法是配置远程仓库与插件仓库，从而解决依赖下载慢、无法访问中央仓库、需要走公司内网 Nexus 等问题。以下是一份完整的配置示例（保留原文档完整内容），它定义了两个 profile：nexus（公司内网私有仓库）和aliyun（阿里云公共镜像），并默认激活nexus：

<?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>D:\maven\my_local_repository</localRepository> <pluginGroups> </pluginGroups> <proxies> </proxies> <profiles> <profile> <id>nexus</id> <repositories> <repository> <id>nexus</id> <url>http://192.168.1.73:8081/repository/maven-public/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>nexus</id> <url>http://192.168.1.73:8081/repository/maven-public/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> <profile> <id>aliyun</id> <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> <pluginRepositories> <pluginRepository> <id>aliyun</id> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles> <activeProfiles> <activeProfile>nexus</activeProfile> </activeProfiles> </settings>

对这份配置的要点逐项说明：

注意：仓库地址中的maven-public是 Nexus 的仓库组（Group Repository），它通常聚合了 releases、snapshots 和代理的中央仓库，因此一个地址即可覆盖绝大多数依赖；aliyunprofile 的地址则是阿里云对中央仓库的公共镜像，适合没有内网环境、但中央仓库访问慢的场景。

在 pom.xml 中用 profile 实现多环境打包

settings.xml中的 profile 负责「从哪下载」，而pom.xml中的 profile 则负责「打哪个环境的包」。以下示例定义了dev和product两个环境 profile：默认激活dev，打包时把src/main/env/${package.environment}目录下的配置文件（如数据库连接、日志级别等）过滤后打进资源目录，从而做到同一份代码、不同环境配置：

<profiles> <profile> <id>dev</id> <properties> <package.environment>dev</package.environment> </properties> <activation> <activeByDefault>true</activeByDefault> </activation> <build> <resources> <resource> <directory>src/main/resources</directory> <includes> <include>**/*</include> </includes> <filtering>true</filtering> </resource> <resource> <directory>src/main/env/${package.environment}</directory> <includes> <include>**/*</include> </includes> <filtering>true</filtering> </resource> </resources> <finalName>${project.artifactId}</finalName> </build> </profile> <profile> <id>product</id> <properties> <package.environment>product</package.environment> </properties> <activation> <activeByDefault>false</activeByDefault> </activation> <build> <resources> <resource> <directory>src/main/resources</directory> <includes> <include>**/*</include> </includes> <filtering>true</filtering> </resource> <resource> <directory>src/main/env/${package.environment}</directory> <includes> <include>**/*</include> </includes> <filtering>true</filtering> </resource> </resources> <finalName>${project.artifactId}</finalName> </build> </profile> </profiles>

这段配置的核心机制：

• <activation><activeByDefault>true</activeByDefault></activation>：devprofile 默认激活，意味着不显式指定环境时，Maven 默认打包src/main/env/dev下的配置文件；
• <properties><package.environment>dev</package.environment></properties>：定义一个属性变量，作为src/main/env/${package.environment}目录名的占位符，切到productprofile 时该变量自动变为product；
• <filtering>true</filtering>：开启资源过滤，src/main/resources与src/main/env/${package.environment}中的${...}占位符会在打包时被替换为实际属性值；
• <finalName>${project.artifactId}</finalName>：指定最终构建产物的名称（默认为「artifactId-version」格式，这里去掉版本号，输出名更简洁）。

因此，构建时选择productprofile，就会把src/main/env/product下的配置文件（如db.properties、logback.xml等）打进最终包，实现一套代码、多环境发布。

IntelliJ IDEA 中使用 Maven Profile：勾选即生效

在 IntelliJ IDEA 中启用/切换 profile 非常简单：在右侧打开Maven Projects工具面板，找到Profiles分组，勾选或取消勾选对应的复选框即可，且支持多选——例如同时勾选nexus与dev，实现「从内网仓库下载 + 按 dev 环境打包」的自由组合。

如上图所示，IDEA 的 Maven 面板中Profiles分组下列出了settings.xml和pom.xml中定义的全部 profile（截图中的aliyun与nexus），每个 profile 前都有一个复选框。取消勾选nexus、勾选aliyun，即等价于把settings.xml中<activeProfiles>改为激活aliyun；而在面板中切换dev/product，则会影响pom.xml中package.environment的取值。由于 IDEA 会结合pom.xml、settings.xml实时解析 profile 状态，勾选后重新导入（点击工具栏Reimport All Maven Projects或直接执行clean package等生命周期命令）即可让新 profile 生效。需要留意的是，部分 profile 只有在特定条件下才可勾选（例如activeByDefault的 profile 被取消勾选后，IDEA 会提示该操作会改变默认激活状态），实际以你所用 IDEA 版本的提示为准。

场景一：只使用 aliyun 仓库

如果你的网络环境访问中央仓库很慢，可以只保留阿里云镜像 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>D:\maven\my_local_repository</localRepository> <pluginGroups> </pluginGroups> <proxies> </proxies> <profiles> <profile> <id>aliyun</id> <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> <pluginRepositories> <pluginRepository> <id>aliyun</id> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles> <activeProfiles> <activeProfile>aliyun</activeProfile> </activeProfiles> </settings>

场景二：同时使用 nexus + aliyun 仓库

在团队内网场景，通常建议保留两个 profile 但默认激活内网 Nexus：内网 Nexus 无法覆盖的构件会继续回源到其代理的公共仓库；而当你离开内网环境时，只需在 IDEA 的 Maven 面板中取消nexus、勾选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"> <localRepository>D:\maven\my_local_repository</localRepository> <pluginGroups> </pluginGroups> <proxies> </proxies> <profiles> <profile> <id>nexus</id> <repositories> <repository> <id>nexus</id> <url>http://192.168.1.73:8081/repository/maven-public/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>nexus</id> <url>http://192.168.1.73:8081/repository/maven-public/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> <profile> <id>aliyun</id> <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> <pluginRepositories> <pluginRepository> <id>aliyun</id> <url>http://maven.aliyun.com/nexus/content/groups/public/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles> <activeProfiles> <activeProfile>nexus</activeProfile> </activeProfiles> </settings>

两个 profile 同时存在的注意事项：Maven 的仓库解析遵循「先激活的 profile 优先」的原则，多个激活 profile 中若定义了同名构件来源，以最先匹配到的仓库为准；同时，releases与snapshots的enabled开关控制了哪些版本会从该仓库下载，例如只希望正式版走 Nexus、快照版走其他仓库时，可以分别调整各自的<enabled>值。

进阶：结合 Maven 组件面板管理依赖与排查冲突

上面的 profile 配置主要解决「仓库来源」和「环境打包」，而日常开发中更频繁打交道的是 IDEA 的Maven 组件面板（对应教程中 Maven 结构项目搭建 一章的讲解）。该面板左侧的工具栏与树形结构提供了几个高频能力，与 profile 配合使用效果更佳：

• Reimport All Maven Projects：在修改pom.xml（新增依赖、插件或 profile）后，如果依赖区没有及时出现最新内容，点击此按钮强制重新导入项目；
• Execute Maven Goal：弹出可执行的 Maven 命令输入框，用于输入clean install -Pproduct这类带 profile 参数的 CLI 命令（命令行指定 profile 的语法为-PprofileId，多个用逗号分隔）；
• Show Dependencies：打开项目依赖结构图，直观查看依赖树；
• 生命周期命令区：通过双击clean、compile、package、install等命令执行对应的构建阶段；
• 插件与依赖列表区：分别展示pom.xml中配置的插件和依赖包。

依赖冲突排查是 Maven 项目的常见痛点：当依赖结构图中出现红色连线时，说明存在同一构件不同版本被同时引入的情况，很可能导致代码无法编译或运行时行为异常。此时可在依赖图上直接编辑、对冲突的传递依赖执行Exclude（排除），保留需要的版本。红色连线基本都应排查并排除，以防止版本不同的依赖包造成编译失败。

另外，在 IDEA 中设置 Maven 时还需注意两点（详见 Maven 结构项目搭建）：

1. Maven 安装目录：可在Settings → Build, Execution, Deployment → Build Tools → Maven中指定本地 Maven 安装目录；若已配置MAVEN_HOME系统环境变量，IDEA 可直接识别；
2. 导入加速设置：默认不勾选「在导入依赖时自动下载源码和文档」，可加快从外网导入依赖的速度；当需要查看某个依赖源码时再针对该依赖单独联网下载即可。若项目导入太慢，也可以适当调大 Maven 导入的 VM 参数。

小结

本篇文章覆盖了 IntelliJ IDEA 配合 Maven 的三大高频场景：

1. 仓库切换：通过settings.xml中的 profile +activeProfiles管理 Nexus / 阿里云等远程仓库，并在 IDEA 的 Maven 面板中勾选切换；
2. 多环境打包：通过pom.xml中的 profile +package.environment属性 +filtering资源过滤，实现 dev/product 环境配置的自动选择；
3. 依赖管理：利用 Maven 组件面板的 Reimport、Execute Maven Goal、Show Dependencies 等能力，配合依赖结构图排除冲突版本。

其中的完整 XML 配置示例均可直接复制使用（替换为自己的仓库地址与本地仓库路径即可）。本教程体系中与 Maven 相关的配套章节还有 Maven 结构项目搭建（IDE 设置与骨架创建）以及 Maven 的单模块 / 多模块 Spring MVC + Spring + Mybatis 项目（SSM 实战），建议按顺序阅读以形成完整知识闭环。

• 文档
• 教程