Gitで特定のブランチのみをクローンする方法

Gitリポジトリの取り扱いについて、少し踏み込んだ話をします。

「リポジトリをクローンして」と言われたとき、何も考えずに git clone [URL] を叩いていませんか？
個人の小さなプロジェクトならそれで構いません。しかし、歴史の長いプロジェクトや、管理が甘いリポジトリでそれをやるのは、時間とリソースの無駄遣いです。

今回は、「必要なブランチだけを、ピンポイントで持ってくる」技術を紹介します。

目次

肥大化したリポジトリのダイエット

なぜ、特定のブランチだけをクローンする必要があるのか。
最大の理由は、「過去のミスによるリポジトリの肥大化」です。

開発の現場では事故が起きます。

  • うっかりコミットしてしまったテスト用の巨大な動画ファイル
  • .gitignore の設定漏れで履歴に残ってしまった node_modules や vendor ディレクトリ
  • 今はもう使われていない、高解像度のデザイン素材

これらは既に削除され、現在の main ブランチには存在しないかもしれません。しかし、Gitの仕組み上、通常の clone をすると、「今はもう使われていない、他のブランチの過去の履歴」として、これらのゴミデータまで全てダウンロードされてしまいます。
今作業したいブランチには関係ないファイルのために、ギガバイト単位の通信とディスク容量を消費するのは、無駄です。

必要なコードだけを最短で手に入れる

今回の目標はシンプルです。

  1. ターゲット： 今必要な「特定のブランチ」のデータだけを取得する。
  2. ダウンロード時間： 全クローン比で 大幅に短縮 する。
  3. ディスク使用量： 過去の不要なデータを 0バイト に抑える。

特に、従量課金のCI/CD環境や、ストレージの限られたVPS、ラズパイなどのIoTデバイスで開発を行う場合、この「ダイエット」はコストとパフォーマンスに直結します。

「とりあえず全クローン」が招く悲劇

何も考えずに全データをクローンすることには、以下のデメリットがあります。

  • 待ち時間の無駄: 回線速度が遅い環境やテザリング時には、GB単位のダウンロードは致命的です。
  • CI/CDのボトルネック: パイプラインが走るたびに無関係な履歴まで取得するため、ビルド開始までの待ち時間が増え、クラウドの実行時間コストが嵩みます。
  • ノイズの増大: git branch -a を叩いた際、顔も知らない誰かが放置した作業ブランチが数百行にわたって表示されます。これは認知負荷を高め、誤操作（間違ったブランチへのマージなど）の原因になります。

道具箱の中身は、今使う道具だけで整頓されているべきです。

【解決策】 -b と –single-branch の合わせ技

結論から言います。以下のコマンドを使ってください。

git clone -b <ブランチ名> --single-branch <リポジトリURL>

オプションの解剖

多くの人が -b （ブランチ指定）だけで満足していますが、それだけでは不十分です。

  • -b <ブランチ名>: クローン完了後に、そのブランチをチェックアウトするだけです。裏では全ブランチのデータをダウンロードしています。
  • –single-branch: これが本命です。「指定したブランチの履歴のみ」をダウンロード対象とします。他のブランチの情報は .git ディレクトリにも保存されません。

実行例

例えば、 fix/nando-patch というブランチだけが必要な場合：

git clone -b fix/nando-patch --single-branch https://github.com/user/repo.git

これで、他のブランチに眠る過去の巨大ファイルは一切ダウンロードされません。

よくある誤解とリカバリ方法

このオプションを使うと「不自由になるのでは？」という懸念があるかもしれません。ここでハッキリさせておきます。

Q1. この状態から新しいブランチは作れる？

A. 作れます。
ここを勘違いしている人が多いですが、制限されるのは「リモートにある他人のブランチを見ること」だけです。
手元に持ってきたコードを元に git checkout -b my-new-feature で派生ブランチを作り、作業を進めることは全く問題ありません。

Q2. 後から「やっぱり全部のブランチが見たい」となったら？

A. 設定を書き換えれば戻せます。
開発が進み、どうしても他のブランチの情報が必要になった場合、以下の手順で制限を解除できます。

1．コンフィグで追跡対象を「全ブランチ」に書き換える

git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"

２．改めて情報を取得する

git fetch origin

これで、通常のリポジトリと同じ状態に戻ります。不可逆な操作ではないので安心してください。

まとめ

シンプルこそ最強の効率化。使い分けの基準

  • 小規模な個人開発: 普通に git clone でOK。
  • CI/CD・デプロイ: 必須。1秒でも速く、軽く。
  • 歴史ある巨大リポジトリ: 必須。過去のファイルをローカルに入れないため。

Gitは便利なツールですが、漫然と使っていると開発体験（DX）を損ないます。「必要なものを、必要な分だけ」。これはDIYにもサーバー管理にも通じる鉄則です。
ぜひ手元のエイリアスに登録して、無駄なデータを持ち込まないクリーンな開発環境を維持してください。

比較＆TipsCLI,git,Technology,Tips,サーバ

Posted by 納戸 工房