🔍 Git 서브모듈(Submodule)이란?

서브모듈은 Git 저장소(Repo) 안에 또 다른 Git 저장소를 하위 디렉토리로 포함할 수 있게 해주는 기능입니다.

즉, 하나의 프로젝트 안에 다른 Git 프로젝트를 연결해서 관리할 수 있게 해주는 기능이에요.

🧠 왜 서브모듈을 사용할까?

• 공통 라이브러리나 외부 오픈소스를 내 프로젝트에 직접 포함하고 싶을 때
• 코드 복붙이 아닌, 원본 저장소와의 연결을 유지하면서 버전을 관리하고 싶을 때
• 여러 프로젝트에서 동일한 의존 저장소를 공유하고자 할 때

🗂 구조 예시

my-project/
├── .git/
├── .gitmodules
├── main-code/
└── shared-lib/   ← 다른 Git 저장소가 연결된 서브모듈

⚙️ .gitmodules 파일이란?

서브모듈 정보를 담고 있는 설정 파일입니다. 예:

[submodule "shared-lib"]
  path = shared-lib
  url = <https://github.com/example/shared-lib.git>

🛠 주요 명령어

📌 서브모듈 초기화 및 업데이트

git submodule update --init --recursive

• 서브모듈을 클론하고, 필요한 커밋으로 체크아웃