git addコマンド完全ガイド：ステージングエリアへのファイル追加をマスターしよう

git addコマンドは、ファイルやフォルダをステージングエリアに追加するためのコマンドです。ステージングエリアにあるファイルは、次のコミットに含めたいファイルを指します。なお、git addはリポジトリやファイル自体を変更・影響を与えることはありません。

Gitバージョン管理システムには、単純な「保存」機能は存在しません。Gitでは「コミット」と呼ばれるプロセスを使用します。コミットとは、前回のコミット以降にファイルに加えられたすべての変更の記録を作成することです。

このプロセスには、いくつかのコマンドライン操作が関わってきます。ファイルやフォルダの変更をGitリポジトリに保存する最初のステップが、git addコマンドの使用です。このコマンドを使うことで、対象のファイルをステージングエリアに移動し、リポジトリにコミットしたいファイルを選択できます。

このチュートリアルでは、具体例を交えながら、git addコマンドを使ってコミットするファイルを選択する方法を解説します。読み終える頃には、git addコマンドをプロのように使いこなせるようになっているでしょう。

Gitにおけるファイルの保存方法

パソコン上でファイルを保存すると、コンピュータはその変更をローカルマシンに記録します。たとえば、Word文書を保存すると、パソコンには文書の新しいバージョンが保存されます。

一方、Gitは異なるアプローチで変更を保存します。作業中のプロジェクトでファイルを保存すると、変更はローカルのコンピュータに記録されます。しかし、Gitリポジトリにその変更を反映させるには、変更をリポジトリにコミットする必要があります。この流れを以下の図に示します。

Gitリポジトリから取得したファイルを変更した後、これらのステップを踏まない限り、リポジトリ自体は変更されません。パソコンにはファイルの新しいバージョンが保存されますが、通常は別のサーバーに保存されているメインリポジトリは変更されないのです。さらに、更新されたファイルをリポジトリにコミットするまで、Gitはファイルへの変更を追跡しません。

Gitリポジトリ内のファイルやフォルダを変更する際のワークフローは以下のとおりです。

1. ローカルのコンピュータ上で、Gitリポジトリ内のファイルやフォルダを更新します。
2. git addを使って、変更をステージングエリアに追加します。
3. git commitを使って、ステージングエリアからコミットへ変更を移動します。
4. git pushを使って、変更をメインリポジトリにプッシュします。

Gitでファイルを保存するには、git addとgit commitという2つのコマンドを使用する必要があります。このチュートリアルでは、そのうちの最初のコマンドであるgit addについて詳しく解説します。

git addコマンドとは？

git addコマンドは、ファイルをGitのステージングエリアに追加します。ステージングエリアには、最近変更したすべてのファイルのリストが含まれています。次にコミットを作成した際に、リポジトリが更新されます。

つまり、git addコマンドを実行しても、Gitリポジトリ内の作業には何の変更も加えられません。リポジトリに変更が反映されるのは、git commitコマンドを実行したときです。

git addコマンドの構文は以下のとおりです。

git add fileName

指定できるファイルは、Gitリポジトリ内の任意のファイルやフォルダです。

たとえば、README.mdというファイルをステージングエリアに追加し、メインリポジトリにコミットしたいとしましょう。この場合、以下のコマンドを使用します。

git add README.md

このコマンドにより、README.mdファイルがステージングエリアに追加されます。

また、上記のコマンドをリポジトリ内のすべての更新済みファイルやフォルダに適用する方法もあります。そのコードは以下のとおりです。

git add --all

このコマンドは、リポジトリ内のファイルやフォルダに加えたすべての変更を、Gitのステージングエリアに追加します。

ファイルをステージングエリアに追加したら、git commitコマンドを使ってリポジトリにコミットできます。git commitコマンドについては、git commitガイドで詳しく解説しています。

Gitですべてのファイルを追加する方法

リポジトリ内のすべてのファイルをステージングエリアに追加するには、git add -Aコマンドまたはgit add .コマンドを使用します。

-Aフラグは、すべてのファイルをリポジトリに追加することを意味します。このフラグは--allの省略形であり、好みに応じて--allを使っても構いません。それでは、すべての変更をステージングエリアに追加してみましょう。

git add -A

これで、ステージングエリアにはファイルに加えたすべての変更が含まれるようになりました。

git add .コマンドを使用することもできます。このコマンドは、現在表示しているフォルダ内のすべてのファイルをステージングエリアに追加します。

git add .コマンドですべてのファイルをステージングエリアに追加するには、プロジェクトのルートフォルダを表示している必要があります。ルートフォルダとは、すべてのコードが保存されているメインフォルダのことです。

それでは、git add .コマンドを使ってみましょう。

git add .

これで、リポジトリ内のすべてのファイルがステージングエリアに追加されました。

Gitステージングエリアとは

このチュートリアルでは、Gitにおける「ステージングエリア」という概念について触れてきました。ステージングエリアは、Gitバージョン管理システム特有の機能です。未保存のコード変更とプロジェクトの履歴の間のバッファとして機能します。

ステージングエリアは非常に便利な機能です。リポジトリ自体を実際に変更することなく、ファイルへの変更を行うことができます。ローカルファイルを編集し、後でリポジトリにコミットすることが可能です。

この機能の活用例として、複数のファイルに変更を加える必要がある場合が挙げられます。そのような場合、変更を複数のコミットに分割したいことがあるでしょう。一度にあまり多くの変更をリポジトリにプッシュしないようにするためです。一度に大量の変更をプッシュすることは、コミット間の変更を追跡しにくくなるため、一般的に避けるべきとされています。

git addを使用することで、特定のファイルだけを選択的にコミットに含めることができます。

バージョン管理の本質は、追跡しやすいコミットを作成することにあります。追跡しやすいコミットは、開発者がコーディングの問題の原因を特定する必要が生じた際に大きな助けとなります。

まとめ

git addコマンドは、Gitリポジトリに変更を保存する一連の操作の最初のコマンドです。このコマンドは、加えた変更をステージングエリアに送ります。その後、git commitを使用して、それらの変更をメインリポジトリにコミットできます。

このチュートリアルでは、具体例を交えながら、git addコマンドを使ってファイルやフォルダをGitのステージングエリアに追加する方法を解説しました。これで、プロのプログラマーのようにgit addコマンドを使い始める準備が整いました！

Gitについてさらに学びたい方は、Git学習ガイドもぜひ参考にしてください。