[Git] Git 저장소에서 특정 폴더만 가져오기 - Git 2.25 이하(구버전)의 sparse-checkout 방식

📋 Git 2.25 이하: 특정 폴더만 sparse-checkout으로 가져오기 (Deprecated 방식)

✅ Git 2.25 이전에는 git sparse-checkout set 명령어가 없었기 때문에,
.git/info/sparse-checkout 파일을 수동으로 작성하는 방식으로 특정 폴더만 가져왔습니다.
이 방식은 현재는 Deprecated 되었지만, 구버전 호환성이나 환경 상 이유로 사용할 수도 있으므로 구조화해 정리합니다.

---

✅ 방식 1: git clone으로 시작하는 경우

🔹 1단계: 저장소 클론 (파일은 다운로드하지 않음)

git clone --no-checkout https://github.com/username/repository.git
cd repository

• --no-checkout: clone 이후 실제 파일 다운로드를 생략
• 이후 sparse-checkout 설정으로 필요한 폴더만 선택할 수 있음

---

✅ 방식 2: git init + remote add 방식

🔹 1단계: 빈 디렉토리 초기화 및 원격 연결

mkdir repository && cd repository
git init

• 새로운 Git 저장소 초기화

git remote add origin https://github.com/username/repository.git

• 원격 저장소 연결

---

🔹 2단계: 원격 브랜치 정보 가져오기

git fetch origin

• origin/main, origin/master 등의 브랜치 정보만 가져오며, 파일은 가져오지 않음

---

✅ 공통: sparse-checkout 설정 및 특정 폴더 가져오기

🔹 3단계: sparse-checkout 기능 활성화

git config core.sparseCheckout true

• sparse-checkout 기능을 사용하겠다고 설정

---

🔹 4단계: 가져오고 싶은 폴더 목록 작성

echo "src/main/java/" >> .git/info/sparse-checkout
echo "docs/" >> .git/info/sparse-checkout

• 경로는 리포지토리 루트 기준 상대경로
• 폴더는 슬래시 /로 끝나야 정확

---

🔹 5단계: 브랜치 checkout

git checkout main

• 지정한 폴더만 로컬에 다운로드됨
• 브랜치가 master인 경우는 main 대신 master

---

📂 예시 디렉토리 구조 (결과)

repository/
├── src/
│   └── main/
│       └── java/
├── docs/

• 지정된 폴더만 로컬 디렉토리에 존재
• 전체 리포지토리를 받지 않아 디스크 절약 가능

---

⚠️ 주의사항 (Deprecated 관련)

항목	설명
직접 편집	.git/info/sparse-checkout 파일을 직접 작성해야 함
실수 위험	오타나 경로 오류 시 원하는 폴더가 내려오지 않음
복잡성	여러 폴더 수정 시 반복적인 수동 편집 필요
공식 상태	Git 2.25 이상에서는 Deprecated → sparse-checkout set 명령어 사용 권장

---

✅ 한 줄 요약

Git 2.25 이전 버전에서는 core.sparseCheckout=true 설정 후 .git/info/sparse-checkout 파일을 직접 수정하여, git checkout 시 특정 폴더만 로컬에 가져오는 방식이 사용되었습니다.

---