2025-12-02 06:45:51

Maven – 镜像设置指南

高级镜子规格

一个镜像可以处理多个存储库。这通常与存储库管理器一起使用，它可以轻松集中配置后面的存储库列表。

语法：

*匹配所有 repo id。

external:*匹配所有存储库，除了那些使用本地主机或基于文件的存储库。当您要排除为集成测试定义的重定向存储库时使用此选项。

从 Maven 3.8.0 开始，external:http:*匹配所有使用 HTTP 的存储库，除了使用 localhost 的存储库。

可以使用逗号作为分隔符指定多个存储库

感叹号可以与上述通配符之一结合使用以排除存储库 ID

注意不要在逗号分隔列表中的标识符或通配符周围包含额外的空格。例如，将 设置为的镜像!repo1, *不会镜像任何内容，而!repo1,*将镜像所有内容，但repo1.

通配符在以逗号分隔的存储库标识符列表中的位置并不重要，因为通配符会延迟进一步处理，并且显式包含或排除会停止处理，从而推翻任何通配符匹配。

当您使用高级语法并配置多个镜像时，声明顺序很重要。当 Maven 查找某个存储库的镜像时，它首先检查与存储库标识符完全匹配的镜像。如果没有找到直接匹配，Maven 会根据上述规则（如果有）选择第一个匹配的镜像声明。因此，您可以通过更改定义的顺序来影响匹配顺序settings.xml

例子：

*= 一切

external:*= 不在本地主机上且不基于文件的所有内容。

repo,repo1=回购或回购1

*,!repo1= 除 repo1 外的所有内容

...

internal-repository

Maven Repository Manager running on repo.mycompany.com

http://repo.mycompany.com/proxy

external:*,!foo

foo-repository

Foo

http://repo.mycompany.com/foo

foo

...