次の方法で共有

ファイル 一致パターンリファレンス

  • [アーティクル]

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

パターンの構文

パターンは、改行で区切られた文字列の文字列またはリストです。 ファイル名とディレクトリ名は、タスクに含める (または除外する) パターンと比較されます。 複数のパターンを積み重ねて複雑な動作を構築できます。 完全な構文ガイドについては、fnmatch の を参照してください。

文字の一致

ほとんどの文字は完全一致として使用されます。 "正確な" 一致としてカウントされるものはプラットフォームに依存します。Windows ファイルシステムでは大文字と小文字が区別されないため、パターン "ABC" は "abc" というファイルと一致します。 大文字と小文字が区別されるファイルシステムでは、そのパターンと名前は一致しません。

次の文字は特殊な動作をします。

  • * は、ファイル名またはディレクトリ名内の 0 個以上の文字と一致します。 例を参照してください。
  • ? は、ファイル名またはディレクトリ名内の任意の 1 文字と一致します。 例を参照してください。
  • [] は、ファイル名またはディレクトリ名内の文字のセットまたは範囲と一致します。 例を参照してください。
  • 再帰ワイルドカード ** します。 たとえば、/hello/**/* は /helloのすべての子孫と一致します。

拡張 globbing

  • ?(hello|world) - hello または 0 または 1 回 world 一致します
  • *(hello|world) - 0 回以上出現
  • +(hello|world) - 1 つ以上の出現回数
  • @(hello|world) - 1 回だけ
  • !(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