Gitの名前とメールアドレスをリポジトリごとに変える方法
Git のコミットに残る名前とメールアドレスは、リポジトリの中で --global を付けずに git config user.name と git config user.email を実行すると、そのリポジトリだけ変えられます。仕事用と個人用のメールアドレスを使い分けたいときや、公開するリポジトリだけ別の名前でコミットしたいときに使う設定です。リポジトリがたくさんあるなら、フォルダごとにまとめて切り替える includeIf も使えます。どちらも、操作の前と後で git config と git log の出力を見比べながら確かめました。
検証環境は Ubuntu 24.04、Git 2.43.0 です。名前とメールアドレスは例示用の値(Neko <neko@example.com> と Tama <tama@example.org>)にしました。リポジトリはホームフォルダの直下に作り、システム全体の設定ファイルは読まない状態(GIT_CONFIG_NOSYSTEM=1)で試しています。Windows・macOS での動作や、GitHub などのホスティングサービスへのプッシュは試していません。
今の名前とメールアドレスが、どの設定から来ているかを見る
最初に、全体の設定(--global)に Neko <neko@example.com> を入れておきました。リポジトリ cat-tools の中で git config user.name と git config user.email を実行すると、今使われる値が表示されます。--show-scope を付けると、その値がどの設定から来たのかも分かります。
$ git config user.name
Neko
$ git config user.email
neko@example.com
$ git config --show-scope --get user.email
global neko@example.com
global は全体の設定のことで、ここではホームフォルダの ~/.gitconfig に書かれています。このままコミットすると、作者は全体の設定の名前とメールアドレスになりました。
$ git log -1 --format="%an <%ae>"
Neko <neko@example.com>
リポジトリの中で –global を付けずに設定する
cat-tools だけ、名前とメールアドレスを Tama <tama@example.org> に変えます。リポジトリの中で、--global を付けずに git config を実行します。
$ git config user.name "Tama"
$ git config user.email "tama@example.org"
$ git config user.name
Tama
$ git config --show-scope --get user.email
local tama@example.org
値の出どころが local(このリポジトリの設定)に変わりました。git config の公式リファレンスにあるとおり、書き込むときに --global などを付けなければ、--local を付けたときと同じく、リポジトリの .git/config に書き込まれます。実際に .git/config を開くと、[user] の節が足されていました。
$ cat .git/config
[core]
repositoryformatversion = 0
filemode = true
bare = false
logallrefupdates = true
[user]
name = Tama
email = tama@example.org
--get-regexp で user. から始まる設定をすべて出すと、全体の設定とこのリポジトリの設定が両方とも並びます。
$ git config --show-scope --get-regexp "^user\."
global user.name Neko
global user.email neko@example.com
local user.name Tama
local user.email tama@example.org
公式リファレンスの説明では、Git は全体の設定、リポジトリの設定の順に設定ファイルを読み、後から読んだ値を優先します。そのため、リポジトリの設定がある cat-tools では Tama が使われます。

他のリポジトリは全体の設定のまま
別のリポジトリ shop では、リポジトリの設定を何もしていないので、全体の設定がそのまま使われました。全体の設定ファイル ~/.gitconfig の中身も、最初に入れた Neko のままです。
$ git config --show-scope --get-regexp "^user\."
global user.name Neko
global user.email neko@example.com
$ git log -1 --format="%an <%ae>"
Neko <neko@example.com>
$ cat ../.gitconfig
[init]
defaultBranch = main
[user]
name = Neko
email = neko@example.com
設定する前に作ったコミットの作者を直す
設定を変えても、すでに作ったコミットの作者は変わりません。cat-tools で設定を変えた直後の履歴を見ると、最初のコミットの作者は Neko のままでした。
$ git log --format="%h %an <%ae> %s"
07b1861 Neko <neko@example.com> 最初のコミット
直前のコミットだけなら、git commit --amend --no-edit --reset-author で今の設定の名前とメールアドレスに直せます。git commit の公式リファレンスによると、--reset-author は --amend などと一緒に使うオプションで、コミットの作者を今コミットする人に置き換えます。作者の日時も新しくなります。
$ git commit -q --amend --no-edit --reset-author
$ git log --format="%h %an <%ae> %s"
d297218 Tama <tama@example.org> 最初のコミット
作者は Tama に変わり、コミットのハッシュも 07b1861 から d297218 に変わりました。作り直した別のコミットになるので、すでにプッシュしたコミットに使うときは、別の記事「git commit –amendで直前のコミットを直す方法」の、プッシュしたコミットを amend したときの節も確かめてください。このあとの新しいコミットは、何もしなくても Tama になりました。
$ git log --format="%h %an <%ae> %s"
31e1290 Tama <tama@example.org> 使い方を追加
d297218 Tama <tama@example.org> 最初のコミット
リポジトリの設定を消して、全体の設定に戻す
リポジトリの設定を消すには、--unset を付けて実行します。cat-tools で消すと、値の出どころが全体の設定だけに戻り、.git/config から [user] の節がなくなりました。
$ git config --unset user.name && git config --unset user.email
$ git config --show-scope --get-regexp "^user\."
global user.name Neko
global user.email neko@example.com
$ cat .git/config
[core]
repositoryformatversion = 0
filemode = true
bare = false
logallrefupdates = true
フォルダごとにまとめて切り替える(includeIf)
リポジトリが増えると、1つずつ設定するのは手間です。全体の設定に includeIf を書くと、決めたフォルダの下にあるリポジトリでだけ、別の設定ファイルを読み込ませられます。ここでは、ホームフォルダの oss の下にあるリポジトリ(cat-lib と cat-cli)を Tama にしました。ここからのコマンドは、どれもホームフォルダから実行しています。cd は、その行のコマンドを実行するためだけに付けていて、次の行はまたホームフォルダから始まります。
まず、切り替えたい名前とメールアドレスを書いたファイル ~/.gitconfig-oss を作ります。
$ printf "[user]\n\tname = Tama\n\temail = tama@example.org\n" > .gitconfig-oss
次に、全体の設定に includeIf を足します。gitdir:~/oss/ は「リポジトリの .git フォルダが ~/oss/ の下にあるとき」という条件です。
$ git config --global includeIf."gitdir:~/oss/".path "~/.gitconfig-oss"
$ cat .gitconfig
[init]
defaultBranch = main
[user]
name = Neko
email = neko@example.com
[includeIf "gitdir:~/oss/"]
path = ~/.gitconfig-oss
oss/cat-cli の中では tama@example.org が、oss の外にある shop の中では neko@example.com が使われました。--show-scope では、読み込んだファイルの値も global と表示され、Neko の後に Tama が並びます。後から読んだ Tama が使われます。
$ cd oss/cat-cli && git config --show-scope --get-regexp "^user\."
global user.name Neko
global user.email neko@example.com
global user.name Tama
global user.email tama@example.org
$ cd oss/cat-cli && git config user.email
tama@example.org
$ cd shop && git config user.email
neko@example.com
oss/cat-lib でコミットすると、作者は Tama になりました。
$ cd oss/cat-lib && printf "# cat-lib\n" > README.md && git add . && git commit -q -m "最初のコミット" && git log -1 --format="%an <%ae>"
Tama <tama@example.org>
gitdir の末尾の / と、includeIf を書く位置
git config の公式リファレンスにある、条件付きで設定ファイルを読み込む仕組み(Conditional includes)の説明によると、gitdir: の後ろは .git フォルダの場所と照らし合わせるパターンで、/ で終わるパターンにはその下のすべてが含まれます。試しに、足した includeIf を消してから、末尾の / を外した gitdir:~/oss で足し直すと、oss の下にある cat-lib でも neko@example.com に戻りました。
$ git config --global --unset includeIf."gitdir:~/oss/".path
$ git config --global includeIf."gitdir:~/oss".path "~/.gitconfig-oss"
$ cd oss/cat-lib && git config user.email
neko@example.com
includeIf を書く位置も結果を左右します。~/.gitconfig を書き直して、includeIf を [user] より前に置くと、oss の下にある cat-lib でも Neko のメールアドレスになりました。公式リファレンスによると、読み込んだファイルの中身は、includeIf を書いた位置にあるものとして扱われます。そのため、読み込んだ Tama の後に、全体の設定の Neko が読まれます。git config --global で includeIf を足すと、検証環境ではファイルの末尾に書き込まれました。
$ cat .gitconfig
[includeIf "gitdir:~/oss/"]
path = ~/.gitconfig-oss
[user]
name = Neko
email = neko@example.com
$ cd oss/cat-lib && git config user.email
neko@example.com
確かめたあと、includeIf は gitdir:~/oss/ に、~/.gitconfig は元の並びに戻しました。
設定し忘れたリポジトリでは、コミットを止める(user.useConfigOnly)
リポジトリごとに設定し忘れると、全体の設定の名前とメールアドレスでコミットしてしまいます。それを防ぐには、全体の設定から名前とメールアドレスを消し、user.useConfigOnly を true にします。git config の公式リファレンスにある user.useConfigOnly の説明によると、true にすると、Git は名前とメールアドレスを推測せず、設定ファイルにある値だけを使います。
$ git config --global --unset user.name && git config --global --unset user.email
$ git config --global user.useConfigOnly true
この状態で、リポジトリの設定がない shop でコミットすると、エラーで止まりました。
$ cd shop && printf "送料\n" >> README.md && git commit -q -am "送料を追加"
Author identity unknown
*** Please tell me who you are.
Run
git config --global user.email "you@example.com"
git config --global user.name "Your Name"
to set your account's default identity.
Omit --global to set the identity only in this repository.
fatal: no email was given and auto-detection is disabled
メッセージの Omit --global … の行にあるとおり、--global を付けずに設定すれば、そのリポジトリでだけ名前とメールアドレスが決まり、コミットできるようになります。includeIf で名前とメールアドレスを読み込む oss の下のリポジトリでは、そのままコミットできました。
$ cd shop && git config user.name "Neko" && git config user.email "neko@example.com" && git commit -q -am "送料を追加" && git log -1 --format="%an <%ae> %s"
Neko <neko@example.com> 送料を追加
$ cd oss/cat-cli && printf "# cat-cli\n" > README.md && git add . && git commit -q -m "最初のコミット" && git log -1 --format="%an <%ae>"
Tama <tama@example.org>





