文件匹配模式参考

  • 项目

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019 |TFS 2018

模式语法

模式是换行分隔字符串的字符串或列表。 文件和目录名称与包含 (模式进行比较，有时在任务中排除) 它们。 可以通过堆叠多个模式来构建复杂的行为。 有关完整语法指南，请参阅 fnmatch 。

匹配字符

大多数字符用作完全匹配项。 计算为“精确”匹配的内容与平台相关：Windows 文件系统不区分大小写，因此模式“ABC”将匹配名为“abc”的文件。 对于区分大小写的文件系统，该模式和名称不匹配。

以下字符具有特殊行为。

  • * 匹配文件或目录名称中的零个或多个字符。 请参阅示例。
  • ? 与文件或目录名称中的任何单个字符匹配。 请参阅示例。
  • [] 与文件或目录名称中的字符集或范围匹配。 请参阅示例。
  • ** 递归通配符。 例如， /hello/**/* 匹配所有子代 /hello。

扩展的旋律

  • ?(hello|world) - 匹配 hello 或零次 world 或一次
  • *(hello|world) - 零个或多个匹配项
  • +(hello|world) - 一个或多个匹配项
  • @(hello|world) - 恰好一次
  • !(hello|world) - 不是 hello 或 world

请注意，扩展 glob 不能跨越目录分隔符。 例如，+(hello/world|other) 就是无效的。

注释

以注释开头 # 的模式被视为注释。

排除模式

前导 ! 更改要排除的包含模式的含义。 可以包括模式，排除其中的子集，然后重新包含其中的子集：这称为“交错”模式。

多个 ! 翻转含义。 请参阅示例。

在排除模式之前，必须定义包含模式。 请参阅示例。

转义

包装特殊字符 [] 可用于转义文件名中的文本 glob 字符。 例如，文本文件名 hello[a-z] 可以转义为 hello[[]a-z]。

斜杠

/ 用作 Linux 和 macOS 上的路径分隔符。 大多数时候，Windows 代理接受 /。 记录必须使用 Windows 分隔符 (\) 的情况。

示例

基本模式示例

星号示例

示例 1： 给定模式 *Website.sln 和文件：

ConsoleHost.sln
ContosoWebsite.sln
FabrikamWebsite.sln
Website.sln

模式将匹配：

ContosoWebsite.sln
FabrikamWebsite.sln
Website.sln

示例 2： 给定模式 *Website/*.proj 和路径：

ContosoWebsite/index.html
ContosoWebsite/ContosoWebsite.proj
FabrikamWebsite/index.html
FabrikamWebsite/FabrikamWebsite.proj

模式将匹配：

ContosoWebsite/ContosoWebsite.proj
FabrikamWebsite/FabrikamWebsite.proj

问号示例

示例 1： 给定模式 log?.log 和文件：

log1.log
log2.log
log3.log
script.sh

模式将匹配：

log1.log
log2.log
log3.log

示例 2： 给定模式 image.??? 和文件：

image.tiff
image.png
image.ico

模式将匹配：

image.png
image.ico

字符集示例

示例 1： 给定模式 Sample[AC].dat 和文件：

SampleA.dat
SampleB.dat
SampleC.dat
SampleD.dat

模式将匹配：

SampleA.dat
SampleC.dat

示例 2： 给定模式 Sample[A-C].dat 和文件：

SampleA.dat
SampleB.dat
SampleC.dat
SampleD.dat

模式将匹配：

SampleA.dat
SampleB.dat
SampleC.dat

示例 3： 给定模式 Sample[A-CEG].dat 和文件：

SampleA.dat
SampleB.dat
SampleC.dat
SampleD.dat
SampleE.dat
SampleF.dat
SampleG.dat
SampleH.dat

模式将匹配：

SampleA.dat
SampleB.dat
SampleC.dat
SampleE.dat
SampleG.dat

递归通配符示例

给定模式 **/*.ext 和文件：

sample1/A.ext
sample1/B.ext
sample2/C.ext
sample2/D.not

模式将匹配：

sample1/A.ext
sample1/B.ext
sample2/C.ext

排除模式示例

给定模式：

*
!*.xml

和文件：

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml
Fabrikam.dll
Fabrikam.pdb
Fabrikam.xml

模式将匹配：

ConsoleHost.exe
ConsoleHost.pdb
Fabrikam.dll
Fabrikam.pdb

双排除

给定模式：

*
!*.xml
!!Fabrikam.xml

和文件：

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml
Fabrikam.dll
Fabrikam.pdb
Fabrikam.xml

模式将匹配：

ConsoleHost.exe
ConsoleHost.pdb
Fabrikam.dll
Fabrikam.pdb
Fabrikam.xml

文件夹排除

给定模式：

**
!sample/**

和文件：

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml
sample/Fabrikam.dll
sample/Fabrikam.pdb
sample/Fabrikam.xml

模式将匹配：

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml