Git Submodule完全ガイド｜複数リポジトリ管理・モノレポ運用をわかりやすく解説

Gitを学び始めた頃は、1つのリポジトリを管理するだけで十分でした。しかし開発規模が大きくなると、「共通ライブラリを複数のシステムで共有したい」「フロントエンドとバックエンドを分けて管理したい」「複数チームが独立して開発できるようにしたい」といった課題に直面します。

そんなときに活躍するのがGit Submodule（サブモジュール）です。

私も複数システムを並行開発する案件で初めてSubmoduleを触ったとき、「なんでリポジトリの中に別のリポジトリがあるんだ？」と戸惑いました。しかし仕組みを理解すると、大規模開発を支える非常に便利な機能だと実感しました。

この記事ではGit上級者向け機能であるSubmoduleについて、仕組みから実践的な使い方までわかりやすく解説していきます。

Git Submoduleとは

Git Submoduleとは、1つのGitリポジトリの中に別のGitリポジトリを組み込むための仕組みです。

通常は1つのプロジェクトに対して1つのリポジトリを利用します。しかしSubmoduleを使うことで、親リポジトリの中に子リポジトリを配置し、それぞれ独立して管理できます。

旅行に例えるなら、旅行計画書の中に各観光地専用のガイドブックを入れて持ち歩くようなイメージです。全体はひとつの旅ですが、各ガイドブックは独立して更新できます。

• 親プロジェクトが全体を管理する
• 子プロジェクトは独立して開発する
• 必要なバージョンだけを参照する
• 依存関係を明確に管理できる

Submoduleはソースコードそのものではなく、子リポジトリの特定コミットを記録します。そのため開発環境ごとの差異を抑えながら、安全に複数プロジェクトを統合できます。

なぜGit Submoduleが必要なのか

近年のシステム開発では、1つの巨大なアプリケーションではなく、複数のサービスやライブラリを組み合わせて構築するケースが増えています。

company-system
├── frontend
├── backend
├── common-library
└── infrastructure

例えば上記のような構成では、共通ライブラリだけを別チームが管理することもあります。

もしすべてを1つのリポジトリに詰め込むと管理が複雑になりますが、Submoduleを利用すれば各プロジェクトを独立して運用しながら全体を統合できます。

Git Submoduleのメリット

依存関係を管理しやすい

親プロジェクトが利用するライブラリや共通機能のバージョンを明確に管理できます。

どのコミットを利用しているかが記録されるため、「自分の環境では動くのに他のメンバー環境では動かない」という問題を減らせます。

コードの再利用性が向上する

共通ライブラリを複数プロジェクトから利用できます。

同じコードを何度もコピーする必要がなくなり、保守性が向上します。

分割統治ができる

機能ごとにリポジトリを分離できるため、開発チームごとに責任範囲を明確にできます。

大規模開発や複数部署が関わるプロジェクトでは特に効果を発揮します。

マイクロサービスとの相性が良い

サービスごとに独立したリポジトリ管理ができるため、マイクロサービスアーキテクチャとの相性も抜群です。

Git Submoduleのデメリット

更新手順が増える

Submodule側でコミットしたあと、親リポジトリ側でも更新情報をコミットする必要があります。

慣れるまでは更新漏れが発生しやすいポイントです。

コミット管理が複雑

Submoduleはファイルではなくコミットを参照しているため、Git初心者には少し理解しづらい仕組みです。

Clone時に注意が必要

通常のgit cloneだけではSubmoduleの内容は取得されません。

専用オプションを付ける必要があります。

Git Submoduleの基本コマンド一覧

Submoduleを追加する

git submodule add リポジトリURL パス

例：

git submodule add https://github.com/example/common-lib.git common-lib

指定したリポジトリを親リポジトリへ組み込みます。

Submoduleを初期化する

git submodule init

Submodule情報をローカル環境へ設定します。

Submoduleを最新化する

git submodule update --remote

リモートリポジトリの最新状態を取得します。

共有ライブラリの最新版を利用したい場合によく使われます。

Submodule込みでCloneする

git clone --recurse-submodules リポジトリURL

Submoduleもまとめて取得できます。

実務では頻繁に登場する重要コマンドです。

Submoduleを削除する

git submodule deinit -f -- パス

不要になったSubmoduleを解除できます。

実務でよくある利用例

• 共通認証ライブラリの共有
• フロントエンドとバックエンドの分離管理
• マイクロサービス構成
• 共通UIコンポーネント管理
• インフラ構成管理の共有
• 複数顧客向けシステムの共通基盤管理

企業開発では、認証基盤や共通ライブラリをSubmoduleとして切り出し、複数プロジェクトから利用するケースが少なくありません。

Git SubmoduleとMonorepoの違い

どちらにもメリットがあります。プロジェクトの規模や開発体制に応じて選択することが重要です。

まとめ

Git Submoduleは、複数リポジトリを統合管理するための強力な仕組みです。

• リポジトリ内に別リポジトリを配置できる
• 依存関係を明確に管理できる
• 共通ライブラリの再利用に最適
• マイクロサービスや大規模開発で活躍する
• コミット管理は少し複雑になる

最初は理解が難しく感じるかもしれません。しかし実際に触ってみると、複数プロジェクトを効率よく管理するための考え方が見えてきます。

Gitの理解をさらに深めたい方は、ぜひSubmoduleを試してみてください。大規模開発の現場で使われる理由がきっと実感できるはずです。