git에서 특정 파일만 checkout

호두·2026년 2월 22일

git sparse-checkout은 거대한 저장소(Monorepo 등)에서 내가 필요한 특정 디렉터리나 파일만 내 컴퓨터(로컬)에 다운로드(Checkout)하여 작업하는 기능

  1. Git의 데이터 저장 방식 (기초 지식)

Commit (커밋): 누가, 언제, 무엇을 변경했는지에 대한 기록
Tree (트리): 디렉토리(폴더) 구조와 파일명 정보
Blob (블롭): 실제 소스 코드, 이미지, 텍스트 등의 파일 내용
보통 git clone을 하면 이 3가지를 전부 다 다운로드

사용 방법

  1. git clone --filter=blob:none --sparse https://github.com/my-org/huge-project.git

  2. cd huge-project

  3. git sparse-checkout set backend --> backend 폴더와 최상위 파일들만 보이게 됨.

  4. git sparse-checkout add docs --> 만약 다른 파일도 가져와야할 경우 add를 하면 docs 폴더와 최상위 파일들이 보이게 됨.

  5. git sparse-checkout init --cone

작업 후 전체 파일을 보고 싶다면 git sparse-checkout disable 로 원복 가능.

profile
Whatever you're not changing, you're choosing

0개의 댓글