[Git] 100MB 넘는 대용량 파일 깃허브에 업로드하기

...

✅ Git LFS로 .mp4 영상 파일 관리하기 (전체 과정 정리)

0️⃣ Git LFS 설치

🔗 git-lfs-windows-v3.6.1.exe 다운로드

설치 후 Git Bash에서 명령어 실행

git lfs install

1️⃣ .mp4 파일을 Git LFS로 트래킹 설정

git lfs track "*.mp4"

이 명령어 실행 시 .gitattributes 파일이 자동 생성되고 다음 내용이 포함

*.mp4 filter=lfs diff=lfs merge=lfs

만약 수동으로 추가하고 싶다면 아래 명령어

echo "*.mp4 filter=lfs diff=lfs merge=lfs" > .gitattributes

2️⃣ .gitattributes 파일도 Git에 포함시키기

git add .gitattributes
git commit -m "Add Git LFS tracking for .mp4 files"

3️⃣ 기존 Git 커밋 히스토리에서 .mp4 파일 LFS로 이동

git lfs migrate import --include="*.mp4" --everything

기존 커밋에 있는 .mp4 파일까지 Git LFS로 이동시킵니다.
히스토리가 변경되므로 강제 푸시가 필요합니다.

4️⃣ 변경사항 원격 저장소에 강제 푸시

git push --force origin main

🎯 왜 Git LFS + migrate import를 써야 하나요 ❓

GitHub는 기본적으로 100MB 이상 파일을 허용하지 않아요.
영상 파일(.mp4)은 크기가 크기에 일반 Git에 커밋하면 업로드 실패 에러가 납니다.
그래서 Git LFS (Large File Storage)를 사용해서
크고 무거운 파일은 Git이 아닌 LFS 전용 저장소에 올리게 하는 거예요.
기존에 올린 .mp4를 Git LFS로 옮기기 위해 git lfs migrate import 사용합니다.
👉 이 명령어는 과거 커밋까지 다 뒤져서 .mp4 파일들을 LFS로 옮겨주는 역할을 해요.