Gitのuser.name・user.emailは何の設定？GitHub・GitLabのアカウントとの違い

git config --global user.name "Hanako Example"
git config --global user.email "hanako@example.com"

Gitの作者情報とアカウント認証の違い

まずは、どこで何を使うのかを並べます。

user.nameは、GitHubやGitLabのユーザー名と違う文字列にできます。たとえば、Gitの名前をHanako Example、GitHubのユーザー名をhanako-devにする使い方です。

Gitが名前を記録するときに、GitHubへ「この名前の人はいますか」と問い合わせる処理はありません。GitHubやGitLabのアカウントを作る前でも、手元のリポジトリでコミットを作れます。この関係は、GitHub・GitLabのどちらを使っても共通です。GitHubのユーザー名設定の説明

commitとpushの動作をおさらい

PC上でファイルを編集してコミットすると、その履歴には名前やメールアドレスが入ります。そのコミットをサーバーに送る操作がpushです。

図の名前とメールアドレスは、履歴の中に残る情報です。下側の認証情報は、サーバーへの接続に使います。

SSH接続では、サーバーに登録した公開鍵に対応する秘密鍵を使います。HTTPS接続では、トークンや認証情報を管理するツールなどを使います。接続先では、認証に加えて対象リポジトリへの操作権限も確認されます。GitHubの認証の説明・GitLabのSSH認証・GitLabのアクセストークン

そのため、user.nameを別のアカウント名に変更しても、そのアカウントの権限が手に入るわけではありません。pushの認証エラーが出たときは、接続先URLや認証情報、リポジトリの権限を確認します。

なお、コミットには作者を表すauthorと、コミットを作成した人を表すcommitterの情報があります。自分の変更を新しいコミットとして記録する例では、この2つに同じ名前・メールアドレスを使います。Gitの設定の説明

メールアドレスでコミットとアカウントを結び付ける

ここでメールアドレスが登場します。GitHubやGitLabは、コミットに記録されたメールアドレスを使って、作者とサービス上のアカウントを関連付けます。

たとえば、GitHubに登録したメールアドレスがhanako@example.comで、コミットにも同じアドレスが記録されていれば、そのコミットをアカウントに関連付けられます。

反対に、PCに古いメールアドレスが残っていると、コミットが期待したアカウント表示につながらない原因になります。pushには成功したのに、作者の表示が思っていたものと違う。この場合は、認証情報に加えてコミット内のメールアドレスを確認してください。

GitLabのプロフィールにあるCommit emailは、GitLabの画面上で行うGit操作に使う設定です。PCのターミナルから作るコミットには、そのPCのGit設定が使われます。GitHubのコミット用メールの説明・GitLabのプロフィール設定

実際のメールアドレスを公開したくないときは？

公開リポジトリへ送るコミットには、名前とメールアドレスも含まれます。プロフィール画面でメールを非表示にしていても、コミットに実際のアドレスを入れていれば、その履歴から確認できます。

個人のメールアドレスを出したくない場合は、各サービスが提供するコミット用アドレスを使えます。

• GitHubでは、アカウントのメール設定に表示されるnoreplyアドレスを使います。
• GitLabでは、プロフィールでUse a private emailを選び、表示されたprivate commit emailを使います。

アドレスは自分の設定画面からコピーします。PC上の対象リポジトリを開き、次のYOUR_PRIVATE_COMMIT_EMAILをコピーしたアドレスに置き換えて設定してください。

git config --local user.email "YOUR_PRIVATE_COMMIT_EMAIL"

GitHubとGitLabで別々のコミット用アドレスを使うときは、各リポジトリのメール設定で指定します。GitHubのコミット用メールの説明・GitLabのprivate commit emailの説明

個人用と仕事用で名前やメールを使い分ける

最初に出てきた--globalは、そのPCで自分のOSユーザーが使うGitの共通設定です。対象リポジトリに個別の設定があると、そちらが優先されます。

仕事用のリポジトリに別のメールアドレスを設定するなら、そのフォルダー内で実行します。

git config --local user.name "Hanako Example"
git config --local user.email "hanako@example.org"

現在のリポジトリで使われる設定は、次のコマンドで確認できます。

git config --get user.name
git config --get user.email

どのファイルから設定が読み込まれたかも確認したいときは、--show-originを付けます。

git config --show-origin --get user.email

アカウントを切り替えたつもりでも、Gitのメール設定はそのまま、ということがあります。新しいリポジトリで作業を始めるときに、この2項目を確認しておくと混乱を減らせます。Gitの設定の説明

【重要】設定を変えても過去のコミットは変わらない

user.nameやuser.emailを変更すると、その後に作るコミットに反映されます。すでに作ったコミットの名前・メールアドレスは、そのまま残ります。

検証用のリポジトリでも、次の動作を確認しました。

直近のコミットに記録された情報は、次のコマンドで確認できます。

git log -1 --format=fuller

これから使う設定と、すでに履歴に入った情報は、確認する場所が違います。公開済みの履歴を直す場合は、共同作業への影響も含めて別の作業として扱います。GitHubの名前変更の説明

困ったときに確認する場所

サーバー側でコミットのメールアドレスなどを検査するルールが設定されている場合は、その条件も確認します。作者情報を記録する処理と、接続先が受け入れる条件を順に追うと、どの設定を直すかを絞れます。

GitHubからGitLabへ移っても、user.nameとuser.emailの役割は共通です。最初に確認するのは、コミットに残す名前・メールと、接続先で使う認証情報です。

参考資料

• Git公式　git config
• GitHub公式　Setting your username in Git
• GitHub公式　Setting your commit email address
• GitLab公式　User account