Gitを使ったバージョン管理は、ソフトウェア開発だけでなくドキュメント管理など、さまざまな場面で活用されています。中でも「git clone
」は、最初に使うことになる基本中の基本コマンドです。リモートリポジトリの内容を手元に複製(クローン)することで、プロジェクトの作業を始める準備が整います。本記事では、git clone
の使い方からオプションの活用方法、トラブルシューティングまで、実用的な視点で詳しく解説します。Gitを初めて触る方にも分かりやすく説明しますので、ぜひ参考にしてください。
git clone
は、リモートリポジトリをローカル環境に複製するコマンドです。GitHubやGitLab、Bitbucketといったリモートサービスで管理されているプロジェクトを、開発者が自分のPC上にダウンロードして利用できるようになります。
このコマンドを実行すると、次のような処理が行われます。
.git
フォルダを含む完全なGitリポジトリが作成されるクローン後は、git pull
やgit push
などのコマンドを通じて、ローカルとリモート間で同期を取ることが可能になります。
最もシンプルな形式のgit clone
コマンドは以下の通りです。
git clone <リポジトリURL>
git clone https://github.com/example-user/sample-project.git
このコマンドを実行すると、カレントディレクトリに「sample-project」という名前のフォルダが作成され、その中にリポジトリの内容が複製されます。
git clone https://github.com/example-user/sample-project.git my-folder
この場合、my-folder
という名前でフォルダが作成され、その中にリポジトリがクローンされます。
git clone
には、いくつか便利なオプションがあります。状況に応じて使い分けると、より柔軟な操作が可能です。
特定のブランチだけをクローンしたい場合に使用します。
git clone -b develop https://github.com/example-user/sample-project.git
この例では、「develop」ブランチだけを取得して、最初からそのブランチがチェックアウトされた状態になります。
履歴を浅くクローンしたい場合に使います。CI環境やテスト用途など、履歴をすべて必要としない場合に便利です。
git clone --depth 1 https://github.com/example-user/sample-project.git
この例では、最新のコミットだけを含んだリポジトリがクローンされます。処理速度も速くなり、容量も軽くなります。
GitリポジトリのURLには、主に「HTTPS」と「SSH」の2種類があります。それぞれに特徴があり、用途や環境に応じて使い分けることが重要です。
git clone https://github.com/example-user/sample-project.git
git clone git@github.com:example-user/sample-project.git
企業やチーム開発などではSSHが推奨されることが多いですが、個人開発や学習目的ならHTTPSでも十分です。
クローンが完了したら、次のコマンドで状態を確認しておきましょう。
cd sample-project
git remote -v
このコマンドで、「origin」がリモートリポジトリとして正しく設定されているか確認できます。
origin https://github.com/example-user/sample-project.git (fetch)
origin https://github.com/example-user/sample-project.git (push)
もしブランチが意図したものと異なる場合は、次のコマンドで切り替えができます。
git checkout main
Git初心者にありがちなgit clone
時のエラーについても紹介しておきます。
git@github.com: Permission denied (publickey).
原因:SSHキーが登録されていない、または間違っている。
対策:
ssh-keygen
で鍵を作成し、GitHubに公開鍵を登録するssh -T git@github.com
で接続テストを行う原因:リポジトリURLが間違っている、またはアクセス権がない
対策:
git clone
は、Gitの世界への入り口ともいえる基本的なコマンドです。リモートリポジトリから自分のPCにコードを複製することで、共同開発やバージョン管理がスムーズに行えるようになります。オプションやプロトコルの違いを理解することで、より快適にGitを活用できるようになるでしょう。
Gitに不慣れなうちは、毎回正しくクローンできるか不安になるかもしれませんが、慣れてしまえば簡単です。ぜひ、いくつかのリポジトリを試しにクローンして、Git操作に慣れていってください。