서브모듈(Git Submodule)은 하나의 Git 리포지토리 안에 다른 Git 리포지토리를 포함 해서 사용하는 방식입니다. 복잡한 프로젝트를 분리하여 관리할 때 유용하지만, 일반적인 프로젝트에서는 관리가 까다롭습니다.

🧩 서브모듈 구조 예시

my-project/
├── .gitmodules
├── main-code/
└── shared-lib/  ← 외부 리포지토리 연결 (서브모듈)

예를 들어, shared-lib이 별도 GitHub 리포이고 my-project 안에 포함한 경우입니다.

🔧 서브모듈 기본 관리 방법

1. 서브모듈 추가

git submodule add <https://github.com/사용자명/레포.git> shared-lib

• 이 명령어는 .gitmodules 파일을 자동 생성하고,
• shared-lib 디렉토리를 외부 리포로 연결합니다.

2. 클론 시 함께 받아오기

git clone <https://github.com/내레포.git>
cd 내레포
git submodule update --init --recursive

또는 한 줄로:

git clone --recurse-submodules <https://github.com/내레포.git>

3. 서브모듈 업데이트

서브모듈 내부로 들어가서 작업한 후, 루트에서 다음 명령으로 업데이트 반영:

cd shared-lib
git checkout main
git pull origin main
cd ..
git add shared-lib
git commit -m "chore: update shared-lib submodule"