Git Ready
ユーザー名やメールを設定する - git config の使い方・オプション・サンプル

ユーザー名やメールを設定する- git config

Gitのユーザー名やメールアドレスなどを設定します。

概念図

git config diagram

構文

bash
git config [--global] <key> <value>

使用例

ユーザー名を設定

bash
git config --global user.name "Your Name"

メールアドレスを設定

bash
git config --global user.email "you@example.com"

設定のスコープ(--system / --global / --local)

設定には3段階のスコープがあり、より狭いスコープの設定が優先されます。

  • --system(システム全体)

    そのマシン上のすべてのユーザーに適用されます。通常は触りません。

  • --global(ユーザー全体)

    ~/.gitconfig に保存され、そのユーザーの全リポジトリで共通になります。最初の user.name / user.email はここに設定するのが定番です。

  • --local(リポジトリ単位)

    .git/config に保存され、そのリポジトリだけに適用されます。プライベート用と仕事用でメールアドレスを分けたい場合などに便利です。

注意点

  • 作成者情報はコミットに永続的に残る

    コミットに記録される作成者情報は user.nameuser.email の設定に基づきます。間違ったメールでコミットすると後から修正するのが面倒なので、最初に確実に設定しておきましょう。

  • プライベートと仕事でメールを使い分けたい

    --global にプライベート用を設定し、仕事用リポジトリでは --local で会社のメールアドレスを設定すると安全です。

  • 設定が反映されているか確認する習慣を

    git config --list で現在有効な設定を一覧できます。意図しない値が残っていないか時々チェックしましょう。

関連コマンド