[Github] LFS로 github에 대용량 파일 업로드 하기

Git Large File Storage (Git LFS) 사용법 정리

Git은 기본적으로 대용량 파일 관리에 적합하지 않아서, 일정 용량(보통 100MB)을 초과하면 push 시 에러가 발생한다.
이때 Git LFS (Large File Storage)를 사용하면 대용량 파일을 효율적으로 관리할 수 있다.

아래에서는 Windows 환경에서 Git LFS 설치 및 설정 방법을 정리해 보겠다.✨

 

 

 

 

 

 

1. Git LFS 다운로드 & 설치

👉 https://git-lfs.com/ 접속 후 Windows 버전 다운로드

 

설치가 끝나면 PowerShell을 열고 아래 명령어 실행:

 

git lfs install

 

 

 

2. 관리할 파일 유형 지정

예를 들어 .zip, .xlsx, .csv 같은 대용량 파일을 Git LFS로 관리하려면 아래 명령어를 입력한다.

git lfs track "*.zip"
git lfs track "*.xlsx"
git lfs track "*.csv"

이 명령어를 실행하면 프로젝트 루트에 .gitattributes 파일이 자동으로 생성된다. 

 

 

 

3. .gitattributes 파일 처리

생성된 .gitattributes 파일을 Git에 반영한다.

git add .gitattributes

 

 

만약 Git 추적에서 제외하고 싶다면 다음 명령어를 사용한다.

git rm --cached .gitattributes

💡 git status에서 .gitattributes 파일을 제외하고 싶을 때 사용

 

 

 

4. 대용량 파일 추가 시 주의사항

한 번에 용량이 큰 파일들을 git add 하면 에러가 발생할 수 있다.

👉 폴더별로 나누어서 git add 하면 에러 없이 push 할 수 있다.