IT系/リファレンス/Gitコマンド/git_config

• Prev
• Next
• IT系/リファレンス/Gitコマンド

git config

Gitの設定を表示、変更する。

用例

• 設定の表示：userセクションのemailキーを表示

  git config user.email

• local, system, globalそれぞれにおける項目の設定値を確認

  git config --local remote.origin.url
  git config --global user.email
  git config --system http.sslbackend

• 設定の一覧表示（コマンドを実行した場所で有効になっている設定項目とその設定値すべて）

  git config -l
  git config --list

• 設定の変更：userセクションのnameキーに"Bankura"と設定

  git config --global user.name "Bankura"

• 設定ファイルをエディタで直接編集（ローカルの設定を変更）

  git config -e
  git config --edit

• 特定の設定ファイルに対して表示・設定を行う（「-f」オプションを使ってファイルを指定。通常local, system, globalオプションを使えば問題ない）

  git config -l -f "C:\Program Files\Git\mingw64\etc\gitconfig"

• 設定されているユーザー名を全て取得

  git config --get-all user.name

書式

git config [options] [name] [value]

公式によると以下の通り。

git config [<file-option>] [--type=<type>] [--show-origin] [--show-scope] [-z|--null] name [value [value_regex]]
git config [<file-option>] [--type=<type>] --add name value
git config [<file-option>] [--type=<type>] --replace-all name value [value_regex]
git config [<file-option>] [--type=<type>] [--show-origin] [--show-scope] [-z|--null] --get name [value_regex]
git config [<file-option>] [--type=<type>] [--show-origin] [--show-scope] [-z|--null] --get-all name [value_regex]
git config [<file-option>] [--type=<type>] [--show-origin] [--show-scope] [-z|--null] [--name-only] --get-regexp name_regex [value_regex]
git config [<file-option>] [--type=<type>] [-z|--null] --get-urlmatch name URL
git config [<file-option>] --unset name [value_regex]
git config [<file-option>] --unset-all name [value_regex]
git config [<file-option>] --rename-section old_name new_name
git config [<file-option>] --remove-section name
git config [<file-option>] [--show-origin] [--show-scope] [-z|--null] [--name-only] -l | --list
git config [<file-option>] --get-color name [default]
git config [<file-option>] --get-colorbool name [stdout-is-tty]
git config [<file-option>] -e | --edit

options

説明

• Gitの設定（ユーザー名やメールアドレスなど）を表示・設定・置換・設定解除する。
• 設定値は設定ファイルに書かれているため、設定ファイルを直接変更することでも変更は可能。
  （ファイルを壊す可能性があるので、-eオプションで編集する）
• 設定値の適用範囲（System:システム全体、Global:ユーザー内、Local:リポジトリ内）毎に設定ファイルが分かれる。同じ設定値がある場合は、適用範囲が狭い方の設定が優先される。
• Localレベルの設定を対象とする場合は、カレントディレクトリを対象リポジトリ内に移動してから実行する必要がある。
• コマンドオプションで適用範囲を指定しない場合、読取りオプションのコマンドでは全設定ファイルの設定値に対して処理を実行する。

Gitの設定レベルの種類と設定ファイルの場所（system, global, local）

Gitの設定レベルは以下の3種類。

system, global, localの順に読み込まれる。例えば、systemとlocalで同じ項目が設定されている場合はlocalの値が有効になる。
設定ファイルの場所は、一例であり、Gitがバンドルされるアプリにより異なる。

設定項目

• コマンドで指定する設定項目名はドットで区切られたセクションとキーで構成される（ex: section.key, section1.section2.key）。
• 設定項目は数多く存在する。よく使われる設定項目は以下。

  設定項目	説明	備考
  color.ui	Gitの出力の色分け（通常はautoを設定）	-
  core.editor	コミットメッセージなどの編集で用いるエディタ	-
  user.name	ユーザー名	-
  user.email	Eメールアドレス	-

リポジトリURLごとの設定

Gitの設定はファイル（~/.gitconfig等）に記述できるが、 Git 1.8.5からはリポジトリURLごとの設定が書けるようになった。
以下は、git-configのman pageに掲載されているリポジトリのホスト名によってhttp.sslVerifyを切り替える例。

[http]
    sslVerify
[http "https://weak.example.com"]
    sslVerify = false
    cookieFile = /tmp/cookie.txt

git configの--get-urlmatchオプションでは、このURLの属性にマッチする値を取得する。

設定ファイルの記載内容

設定ファイルの記載内容は以下のようになっている。公式より引用。

#
# This is the config file, and
# a '#' or ';' character indicates
# a comment
#
;
; core variables
[core]
	; Don't trust file modes
	filemode = false
;
; Our diff algorithm
[diff]
	external = /usr/local/bin/diff-wrapper
	renames = true
;
; Proxy settings
[core]
	gitproxy=proxy-command for kernel.org
	gitproxy=default-proxy ; for all the rest
;
; HTTP
[http]
	sslVerify
[http "https://weak.example.com"]
	sslVerify = false
	cookieFile = /tmp/cookie.txt

上記設定ファイルへのコマンド実行例

• filemodeをtrueに変更するには

  git config core.filemode true

• gitproxyのkernel.orgのエントリを "ssh"に変更するには

  git config core.gitproxy '"ssh" for kernel.org' 'for kernel.org$'

• diff.renamesのエントリを削除するには

  git config --unset diff.renames

• core.filemodeの設定値を確認するには

  git config --get core.filemode

  または

  git config core.filemode

• 多項目値を条件を指定して確認するには

  git config --get core.gitproxy "for kernel.org$"

• 多項目値のすべての値を知りたい場合は

  git config --get-all core.gitproxy

関連

• gitコマンド

参考リンク

• git config - Gitコマンド虎の巻
• Git - git-config Documentation
• Gitの設定をgit configで確認・変更 | note.nkmk.me
• config - [Reference/Git] ぺんたん info
• gitconfig の基本を理解する - Qiita
• Gitを使い始めたら一番最初にやりたい `git config`設定メモ
• git config | Atlassian Git Tutorial
• Git の設定をリポジトリごとに自動で使い分ける | Articles | Riotz.works
• transitive.info - git config 使い方
• Git入門 その10 / git config / 基本的な設定を行う - takafumi blog
• git commitで使われるメールアドレスをスマートに切り替える方法 : KLabGames Tech Blog

その他メモ

• git configの user.emailの存在意義
  もともとgitはLinuxカーネルの構成管理の目的で作られたツールであるため、どこのだれが変更を行ったのか、連絡が取れる必要があった。
  そのため、個人のプロジェクトで使う分には、emailなどは不要だが、慣例的に一応ユーザ名とセットで設定するようにしている。
  GitHubやBitbucketではuser.emailを使ってどのユーザのコミット履歴として扱うか決めている模様（なので自己申告でコロコロ変わるHNよりもメアドの方が重要）。
  （参考：https://teratail.com/questions/123116）

• Prev
  IT系/リファレンス/Gitコマンド/git_commit-tree
• Next
  IT系/リファレンス/Gitコマンド/git_count-objects
• Home
  Up