Referência de padrões de correspondência de ficheiros

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Sintaxe de padrão

Um padrão é uma cadeia de caracteres ou uma lista de cadeias de caracteres delimitadas por novas linhas. Os nomes de arquivos e diretórios são comparados a padrões para incluí-los (ou às vezes excluí-los) em uma tarefa. Você pode criar um comportamento complexo empilhando vários padrões. Consulte fnmatch para obter um guia de sintaxe completo.

Corresponder caracteres

A maioria dos caracteres são usados como correspondências exatas. O que conta como uma correspondência "exata" depende da plataforma: o sistema de arquivos do Windows não diferencia maiúsculas de minúsculas, então o padrão "ABC" corresponderia a um arquivo chamado "abc". Em sistemas de arquivos que diferenciam maiúsculas de minúsculas, esse padrão e nome não corresponderiam.

Os caracteres a seguir têm um comportamento especial.

  • * corresponde a zero ou mais caracteres dentro de um nome de arquivo ou diretório. Ver exemplos.
  • ? corresponde a qualquer caractere único dentro de um nome de arquivo ou diretório. Ver exemplos.
  • [] corresponde a um conjunto ou intervalo de caracteres dentro de um nome de arquivo ou diretório. Ver exemplos.
  • ** curinga recursivo. Por exemplo, /hello/**/* corresponde a todos os descendentes de /hello.

Globbing estendido

  • ?(hello|world) - jogos hello ou world zero ou uma vez
  • *(hello|world) - zero ou mais ocorrências
  • +(hello|world) - uma ou mais ocorrências
  • @(hello|world) - exatamente uma vez
  • !(hello|world) - não hello ou world

Observe que os globs estendidos não podem abranger separadores de diretório. Por exemplo, +(hello/world|other) não é válido.

Comentários

Os padrões que começam com # são tratados como comentários.

Excluir padrões

A liderança ! altera o significado de um padrão de inclusão para excluir. Você pode incluir um padrão, excluir um subconjunto dele e, em seguida, reincluir um subconjunto dele: isso é conhecido como um padrão "intercalado".

Múltiplos ! inverte o significado. Ver exemplos.

Você deve definir um padrão de inclusão antes de um de exclusão. Ver exemplos.

Fuga

O encapsulamento de caracteres especiais pode [] ser usado para escapar de caracteres glob literais em um nome de arquivo. Por exemplo, o nome hello[a-z] do arquivo literal pode ser escapado como hello[[]a-z].

Barra

/ é usado como separador de caminho no Linux e macOS. Na maioria das vezes, os agentes do Windows aceitam /o . As ocasiões em que o separador do Windows (\) deve ser usado são documentadas.

Exemplos

Exemplos básicos de padrões

Exemplos de Asterisk

Exemplo 1: Dado o padrão *Website.sln e os ficheiros:

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

O padrão corresponderia:

ContosoWebsite.sln
FabrikamWebsite.sln
Website.sln

Exemplo 2: Dado o padrão *Website/*.proj e os caminhos:

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

O padrão corresponderia:

ContosoWebsite/ContosoWebsite.proj
FabrikamWebsite/FabrikamWebsite.proj

Exemplos de pontos de interrogação

Exemplo 1: Dado o padrão log?.log e os ficheiros:

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

O padrão corresponderia:

log1.log
log2.log
log3.log

Exemplo 2: Dado o padrão image.??? e os ficheiros:

image.tiff
image.png
image.ico

O padrão corresponderia:

image.png
image.ico

Exemplos de conjuntos de caracteres

Exemplo 1: Dado o padrão Sample[AC].dat e os ficheiros:

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

O padrão corresponderia:

SampleA.dat
SampleC.dat

Exemplo 2: Dado o padrão Sample[A-C].dat e os ficheiros:

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

O padrão corresponderia:

SampleA.dat
SampleB.dat
SampleC.dat

Exemplo 3: Dado o padrão Sample[A-CEG].dat e os ficheiros:

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

O padrão corresponderia:

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

Exemplos de curingas recursivos

Dado o padrão **/*.ext e arquivos:

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

O padrão corresponderia:

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

Excluir exemplos de padrões

Dado o padrão:

*
!*.xml

e ficheiros:

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

O padrão corresponderia:

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

Exclusão dupla

Dado o padrão:

*
!*.xml
!!Fabrikam.xml

e ficheiros:

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

O padrão corresponderia:

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

Exclusão de pasta

Dado o padrão:

**
!sample/**

e ficheiros:

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

O padrão corresponderia:

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml