🧭
ディレクトリごとに Git のユーザーを自動切替する最小構成
やりたいこと
例として、~/projects-work/は work-user、~/projects-personal/は personal-user という別アカウントでコミット&Push したいです。運用は HTTPS(PAT)で、SSH 鍵は使いません。
先にまとめ
-
includeIfを使って「ディレクトリごとに読む設定ファイル」を切り替えます。 - PAT(HTTPS)のアカウント分離は
credential.useHttpPath=trueと ユーザー名入り URL(https://<account>@github.com/...)でやります。
前提
- WSL で動作検証しています。ホームは
/home/exampleとします(各自のユーザー名に読み替えてください)。 - リポジトリ配置の例:
-
~/projects-work/…… 仕事用の作業ツリー(work-user) -
~/projects-personal/…… 個人用の作業ツリー(personal-user)
-
最小構成ファイル(3つだけ)
1) ~/.gitconfig
[credential]
useHttpPath = true
# ディレクトリごとに別ファイルを読む(絶対パス/末尾の / が重要)
[includeIf "gitdir:/home/example/projects-work/"]
path = /home/example/.gitconfig-work
[includeIf "gitdir:/home/example/projects-personal/"]
path = /home/example/.gitconfig-personal
-
gitdir:は .git ディレクトリの実パスに対する前方一致です。 -
末尾に
/を付けると、その配下すべてに効きます。 - ここにはデフォルトの
[user]は置かず、サブ設定側で名乗ります。
2) ~/.gitconfig-work(work-user 用)
[user]
name = work-user
email = work.user@example.com
[credential "https://github.com"]
username = work-user
3) ~/.gitconfig-personal(personal-user 用)
[user]
name = personal-user
email = personal.user@example.com
[credential "https://github.com"]
username = personal-user
リモート URL(PAT の分離ルール)
HTTPS で複数アカウントを併用する場合は、リモート URL にユーザー名を入れるのがいちばん素直です。初回の認証時に、そのユーザーに対応する PAT を保存できます。
- Work 側(
~/projects-work/)のクローン例
$ git clone https://work-user@github.com/ORG/REPO.git
- Personal 側(
~/projects-personal/)のクローン例
$ git clone https://personal-user@github.com/ORG/REPO.git
既存リポのリモートを書き換える場合は、各リポで:
# 例:Personal 側の既存リポ
$ git remote set-url origin https://personal-user@github.com/ORG/REPO.git
動作確認
# Work 側
$ cd ~/projects-work/任意のrepo
$ git config --show-origin --get user.name
file:/home/example/.gitconfig-work work-user
$ git config --show-origin --get user.email
file:/home/example/.gitconfig-work work.user@example.com
# Personal 側
$ cd ~/projects-personal/任意のrepo
$ git config --show-origin --get user.name
file:/home/example/.gitconfig-personal personal-user
$ git config --show-origin --get user.email
file:/home/example/.gitconfig-personal personal.user@example.com
Discussion