【Git】.gitignore のパス指定方法まとめ（ファイル・フォルダ・パターン）

.gitignore の基本

.gitignoreは、Gitに管理させたくないファイルやフォルダを指定するための設定ファイルです。

プロジェクトのルートディレクトリに配置するのが一般的です。

.gitignore の記述方法

.gitignoreファイルは基本的に1行に1つのパターンを記述します。

この場合、それぞれの意味は次のとおりです。

1行目の#で始まる行は、コメントとして扱われGitの動作には影響を与えません。

.gitignoreの中で設定の意図や説明を記載するのに使用します。

2行目のexample.txtは、パスを限定せずにGitに管理させたくないファイルを指定しています。

ファイル・フォルダの指定方法

特定のファイルを無視する

リポジトリ内にある全ての「example.txt」ファイルが無視の対象になります。

特定のフォルダ内のファイルを無視する

リポジトリ内の「example」フォルダにある「example.txt」ファイルが無視の対象になります。

フォルダを指定してフォルダ内の全てのファイルを無視する

「example」フォルダ内の全てのファイルが無視の対象になります。

ワイルドカードを活用した指定方法

特定の拡張子のファイルを無視する

*は任意の文字列という意味で、以下の記述の場合.log拡張子のファイルが全て無視の対象になります。

ネストされたフォルダの特定のパターンを無視する

**は任意のフォルダまたはファイルという意味で、以下の場合リポジトリ内のどのディレクトリ階層にあっても「example」フォルダの内の全てのファイルが無視の対象になります。

例外の指定方法

.gitignoreでは、通常の無視ルールとは逆に、特定のファイルやフォルダを例外としてGitに含めることができます。

その場合、!を先頭に付けます。

上記の場合、*.txtにより、すべての.txtファイルが無視されます。

しかし!important.txtによって、important.txtは例外としてGitに追加されます。

エスケープが必要なケース

.gitignoreでは、パス名や特殊文字を正しく処理するためにエスケープが必要な場合があります。

エスケープは円マーク¥またはバックスラッシュ\で行うことができます。

以下に2つ例をあげます。

スペースを含むフォルダやファイル名を指定する

/My Folder/フォルダを無視したい場合、/My\ Folder/と指定します。

# をファイル名に含める場合

#をファイル名に含める場合、コメントと誤認識されるためエスケープが必要です。

#sample.txtファイルを無視したい場合、\#sample.txtと指定します。

.gitignoreに記述しても無視されない場合の対処法

コマンドで無視されているか確認

.gitignoreに例外を追加しても、すでに追跡されているファイルは無視されません。

そのため、以下コマンドで追跡を解除する必要があります。