はじめに
Git は、開発者がコードの変更を追跡できる強力なバージョン管理システムです。Git を使用していると、コミットを実行しようとした際に「fatal: unable to auto-detect email address（致命的：メールアドレスを自動検出できません）」というエラーメッセージが表示されることがあります。このエラーは、Git がリポジトリに変更を加えている人物を識別するためにメールアドレスを必要とするために発生します。
この実験（Lab）では、このエラーが発生する理由と、Git のメール設定を適切に構成することで解決する方法を学びます。このチュートリアルを終える頃には、Git の ID を正常に設定し、この一般的なエラーに遭遇することなくコミットを実行できるようになります。
Git の設定と現在の設定の理解
メールアドレスのエラーを修正する前に、Git の設定と現在の設定を確認する方法を理解することが重要です。
Git は、設定を次の 3 つのレベルで保存します。
- システムレベル: システム上のすべてのユーザーに適用されます。
- グローバルレベル: 現在のユーザーのすべてのリポジトリに適用されます。
- ローカルレベル: 特定のリポジトリにのみ適用されます。
Git の ID にとって最も重要な設定は user.name と user.email です。これらの値は、Git リポジトリ内のコミットの作成者を識別するために使用されます。
現在の Git 設定の確認
まず、git config コマンドを使用して、既存の Git 設定があるかどうかを確認しましょう。ターミナルを開き、以下を実行します。
git config --list
このコマンドは、現在のすべての Git 設定を表示します。出力は次のようになります。
user.name=Your Name
user.email=your.email@example.com
core.editor=nano
color.ui=auto
出力に user.name または user.email が表示されない場合、まだ Git の ID を設定していません。
次のようなコマンドで、特定の設定を確認することもできます。
git config user.name
git config user.email
これらのコマンドが値を返さない場合は、「unable to auto-detect email address（メールアドレスを自動検出できません）」エラーを回避するために、それらを設定する必要があります。
この実験（Lab）で使用するテストディレクトリに移動しましょう。
cd ~/project/git-test
このディレクトリは、次の手順でエラーとその解決策を説明するために使用されます。
エラーの再現
問題をよりよく理解するために、まず「fatal: unable to auto-detect email address（致命的：メールアドレスを自動検出できません）」エラーを再現してみましょう。このエラーは通常、メールアドレスを設定せずに Git コミットを実行しようとした場合に発生します。
新しい Git リポジトリの初期化
まず、テストディレクトリに新しい Git リポジトリを初期化しましょう。
git init
空の Git リポジトリが初期化されたことを示すメッセージが表示されるはずです。
Initialized empty Git repository in /home/labex/project/git-test/.git/
テストファイルの作成
次に、コミットを試みる簡単なテストファイルを作成しましょう。
echo "This is a test file" > test.txt
このコマンドは、内容が "This is a test file" である test.txt という名前のファイルを作成します。
ファイルを Git ステージングエリアに追加
次に、このファイルを Git ステージングエリアに追加しましょう。
git add test.txt
出力がない場合は、ファイルが正常にステージングエリアに追加されたことを意味します。
ファイルのコミットを試みる
次に、Git のメールを設定せずにファイルのコミットを試みましょう。
git commit -m "Initial commit"
Git のメールが設定されていない場合、次のようなエラーメッセージが表示されます。
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: unable to auto-detect email address (got 'labex@hostname.(none)')
このエラーは、Git が誰がコミットを行っているのかを知る必要があるために発生します。すべての Git コミットには作成者情報が含まれており、Git はこの情報なしでは続行できません。
これで、エラーが発生する理由がわかったので、次のステップで解決に進むことができます。
Git のメール設定
エラーを理解したので、それを解決するために Git のメール設定を行いましょう。Git の ID は、グローバル（すべてのリポジトリに対して）またはローカル（現在のリポジトリに対してのみ）のいずれかで設定できます。
Git ID のグローバル設定
Git の ID をグローバルに設定するには、システム上のすべてのリポジトリに適用されます。次のコマンドを使用します。
git config --global user.email "your.email@example.com"
git config --global user.name "Your Name"
your.email@example.com を実際のメールアドレスに、Your Name を実際の名前で置き換えます。例：
git config --global user.email "labex.user@example.com"
git config --global user.name "LabEx User"
これらのコマンドを実行した後、出力は表示されません。これは、設定が成功したことを意味します。
Git ID のローカル設定
プロジェクトごとに異なるメールアドレスを使用したい場合は、現在のリポジトリに対してのみ Git をローカルに設定できます。
git config user.email "your.email@example.com"
git config user.name "Your Name"
ここでも、プレースホルダーの値を実際の情報に置き換えます。
設定の検証
Git の設定が成功したことを確認するには、設定を確認できます。
git config user.email
git config user.name
出力には、設定したメールアドレスと名前が表示されます。
labex.user@example.com
LabEx User
これで Git の ID が正しく設定され、「unable to auto-detect email address（メールアドレスを自動検出できません）」エラーに遭遇することなく、コミットを実行できるようになります。
新しい設定でのコミット
Git の ID を設定したので、エラーが解決されたことを確認するためにコミットを行いましょう。
Git ステータスの確認
まず、Git リポジトリのステータスを確認して、コミットのためにステージングされているファイルを確認しましょう。
git status
次のような出力が表示されるはずです。
On branch master
No commits yet
Changes to be committed:
(use "git rm --cached <file>..." to unstage)
new file: test.txt
これにより、test.txt ファイルがまだステージングエリアにあり、コミットする準備ができていることが確認されます。
コミットの実行
次に、ファイルをもう一度コミットしてみましょう。
git commit -m "Initial commit"
Git の ID が正しく設定されている場合、コミットを確認するメッセージが表示されます。
[master (root-commit) 1234abc] Initial commit
1 file changed, 1 insertion(+)
create mode 100644 test.txt
正確なコミットハッシュ（この例では 1234abc）は、システムによって異なります。
コミット作成者情報の検証
コミットに正しい作成者情報が含まれていることを確認するには、Git ログを表示します。
git log
次のような出力が表示されるはずです。
commit 1234abc...
Author: Your Name <your.email@example.com>
Date: Mon Jan 01 12:00:00 2023 +0000
Initial commit
Author: 行には、前の手順で設定した名前とメールアドレスが表示されるはずです。
おめでとうございます。Git の ID を正常に設定し、「fatal: unable to auto-detect email address（メールアドレスを自動検出できません）」エラーに遭遇することなく、コミットを実行できました。
グローバル設定とローカル設定の使い分け
- グローバル設定（
--global）は、個人的なプロジェクトに取り組む場合や、すべてのプロジェクトで同じ ID を使用する場合に役立ちます。 - ローカル設定（
--globalなし）は、仕事と個人的なプロジェクトを区別するなど、異なる ID が必要なさまざまなプロジェクトに貢献する場合に役立ちます。
ローカル設定はグローバル設定よりも優先されるため、特定のリポジトリに対して常にグローバル設定を上書きできることに注意してください。
まとめ
この実験（Lab）では、ID 設定を適切に構成することにより、Git での「fatal: unable to auto-detect email address（メールアドレスを自動検出できません）」エラーを解決する方法を学びました。達成した内容は次のとおりです。
- Git の設定レベル（システム、グローバル、ローカル）を理解しました。
- 既存の Git 設定を確認しました。
- 「unable to auto-detect email address（メールアドレスを自動検出できません）」エラーを再現しました。
- Git のメールと名前の設定を行いました。
- 新しい設定でコミットを正常に実行しました。
これらのスキルは、Git を使用するすべての人にとって不可欠です。なぜなら、適切な ID 設定は、変更を追跡し、他の人と効果的に共同作業を行うために必要不可欠だからです。Git の ID を設定することにより、エラーを解決するだけでなく、プロジェクト履歴で自分の貢献が正しく帰属されるようにすることもできます。
ローカル設定を使用することで、異なるプロジェクトに対して異なる ID を設定できることを覚えておいてください。これは、仕事と個人的なプロジェクトを区別する場合に役立ちます。
