🧭

ディレクトリごとに 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