Git は構成ファイルの 4 つの場所をチェックします。
- マシンのシステム
.gitconfig
ファイル。
- にあるユーザー
.gitconfig
ファイル~/.gitconfig
。
$XDG_CONFIG_HOME/git/config
またはにある 2 番目のユーザー固有の構成ファイル$HOME/.config/git/config
。
- ローカル リポジトリの構成ファイル
.git/config
。
設定は次の順序でカスケードされ、各ファイルはその上のファイルで定義された設定を追加またはオーバーライドします。
- システム構成。
- ユーザー構成。
- リポジトリ固有の構成。
次のコマンドを使用して、各ファイルが定義した内容を確認できます。
# System, applies to entire machine and all users
$ git config --system --list
$ git config --system --edit
# User defined
$ git config --global --list
$ git config --global --edit
そのリポジトリのファイルを開くと、リポジトリ固有のファイルだけが定義した内容を確認でき.git/config
ます。
Windows で MSysGit を使用している場合、Windows コマンド プロンプトから使用すると、ユーザー~/.gitconfig
ファイルがどこを指していても見つかるはずです。%homepath%
echo %homepath%
のドキュメントからgit config
:
で明示的に設定されていない場合、構成オプションを検索する--file
4 つのファイルがあります。git config
2 番目のユーザー固有の構成ファイル。$XDG_CONFIG_HOME
が設定されていないか空の場合は、$HOME/.config/git/config
使用されます。このファイルに設定された単一値の変数は、 にあるものによって上書きされます~/.gitconfig
。古いバージョンの Git を使用することがある場合は、このファイルを作成しないことをお勧めします。これは、このファイルのサポートがかなり最近追加されたためです。
ユーザー固有の構成ファイル。「グローバル」構成ファイルとも呼ばれます。
$GIT_DIR/config
リポジトリ固有の構成ファイル。
それ以上のオプションが指定されていない場合、すべての読み取りオプションは、利用可能なこれらのファイルをすべて読み取ります。グローバルまたはシステム全体の構成ファイルが利用できない場合、それらは無視されます。リポジトリ構成ファイルが利用できないか、読み取れない場合、 はgit config
ゼロ以外のエラー コードで終了します。ただし、どちらの場合も、エラー メッセージは発行されません。
ファイルは上記の順序で読み取られ、最後に見つかった値が以前に読み取られた値よりも優先されます。複数の値が取得されると、すべてのファイルのキーのすべての値が使用されます。
すべての書き込みオプションは、デフォルトでリポジトリ固有の構成ファイルに書き込みます。--replace-all
これは、 や などのオプションにも影響することに注意してください
--unset
。git config
一度に 1 つのファイルのみを変更します。
これらのルールは、コマンド ライン オプションまたは環境変数によってオーバーライドできます。およびオプションは--global
、--system
使用するファイルをそれぞれグローバル ファイルまたはシステム全体のファイルに制限します。環境変数にも同様のGIT_CONFIG
効果がありますが、任意のファイル名を指定できます。