文件匹配模式参考
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