チャプター ▾ 第2版

2.1 Gitの基本 - Gitリポジトリの取得

Gitを使い始めるにあたり、もし1章だけ読むとしたら、この章がその1章です。この章では、Gitを使って最終的に行うことになることの大部分に必要な、すべての基本的なコマンドを扱います。この章の終わりまでに、リポジトリの設定と初期化、ファイルの追跡の開始と停止、変更のステージングとコミットができるようになるはずです。また、特定のファイルやファイルパターンをGitに無視させる方法、間違いを素早く簡単に元に戻す方法、プロジェクトの履歴を閲覧してコミット間の変更を表示する方法、リモートリポジトリへのプッシュとプルを行う方法も紹介します。

Gitリポジトリの取得

Gitリポジトリは通常、次の2つの方法のいずれかで取得します。

  1. 現在バージョン管理下にないローカルディレクトリをGitリポジトリに変換するか、または

  2. 既存のGitリポジトリを別の場所からクローンします。

いずれの場合も、手元のローカルマシンにGitリポジトリが用意され、作業を開始できます。

既存のディレクトリにリポジトリを初期化する

現在バージョン管理下にないプロジェクトディレクトリがあり、それをGitで管理したい場合、まずそのプロジェクトのディレクトリに移動する必要があります。これまでに行ったことがない場合、実行しているシステムによって少し異なります

Linuxの場合

$ cd /home/user/my_project

macOSの場合

$ cd /Users/user/my_project

Windowsの場合

$ cd C:/Users/user/my_project

と入力します

$ git init

これにより、必要なリポジトリファイルすべてを含む.gitという新しいサブディレクトリが作成されます。これはGitリポジトリのスケルトンです。この時点では、プロジェクト内の何も追跡されていません。作成した.gitディレクトリに正確にどのようなファイルが含まれているかについての詳細は、Gitの内部構造を参照してください。

既存のファイル（空のディレクトリとは対照的に）のバージョン管理を開始したい場合は、おそらくそれらのファイルを追跡し、最初のコミットを行うことから始めるべきです。これは、追跡したいファイルを指定するいくつかのgit addコマンドに続けて、git commitを実行することで達成できます。

$ git add *.c
$ git add LICENSE
$ git commit -m 'Initial project version'

これらのコマンドが何をするのかは、すぐに説明します。この時点で、追跡されたファイルと最初のコミットを持つGitリポジトリができました。

既存のリポジトリのクローン作成

既存のGitリポジトリのコピーを取得したい場合、例えば貢献したいプロジェクトの場合など、必要なコマンドはgit cloneです。Subversionのような他のVCSに慣れている場合、コマンドが「checkout」ではなく「clone」であることに気づくでしょう。これは重要な違いです。作業コピーだけを取得するのではなく、Gitはサーバーが持っているほぼすべてのデータの完全なコピーを受け取ります。git cloneを実行すると、デフォルトでプロジェクトの履歴の各ファイルのすべてのバージョンがダウンロードされます。実際、サーバーディスクが破損した場合でも、クライアント上のほぼすべてのクローンを使用して、サーバーをクローン作成時の状態に戻すことができます（サーバー側のフックなどは失われる可能性がありますが、すべてのバージョン管理されたデータはそこにあります。詳細についてはサーバーでのGitの取得を参照してください）。

git clone <url>でリポジトリをクローンします。例えば、libgit2というGitのリンク可能ライブラリをクローンしたい場合は、次のようにします。

$ git clone https://github.com/libgit2/libgit2

これにより、libgit2という名前のディレクトリが作成され、その中に.gitディレクトリが初期化され、そのリポジトリのすべてのデータがダウンロードされ、最新バージョンの作業コピーがチェックアウトされます。作成された新しいlibgit2ディレクトリに入ると、プロジェクトファイルがそこにあるのがわかり、作業したり使用したりする準備ができています。

リポジトリをlibgit2以外のディレクトリ名にクローンしたい場合は、新しいディレクトリ名を追加の引数として指定できます。

$ git clone https://github.com/libgit2/libgit2 mylibgit

このコマンドは前のコマンドと同じことを行いますが、ターゲットディレクトリはmylibgitという名前になります。

Gitには、使用できるさまざまな転送プロトコルがあります。前の例ではhttps://プロトコルを使用していますが、git://や、SSH転送プロトコルを使用するuser@server:path/to/repo.gitも目にすることがあります。サーバーでのGitの取得では、サーバーがGitリポジトリにアクセスするために設定できるすべての利用可能なオプションと、それぞれの長所と短所を紹介します。

scroll-to-top