HOWTO · Git

원격 저장소에서 가져올 때 로컬 변경 사항 무시

로컬 변경 사항을 보존하려면 `git stash`나 커밋을 사용하고, 추적 중인 변경 사항을 버리려면 fetch와 reset을 사용해 원격 브랜치에 맞추는 방법을 설명합니다.

이 페이지의 내용

로컬 편집 내용 때문에 업데이트가 진행되지 않으면, 먼저 그 내용을 보존할지 결정하세요. 작업을 잠시 따로 보관하려면 git stash를 사용하고, 브랜치를 전환하기 전에 커밋해도 됩니다. 추적 중인 변경 사항을 버리고 현재 브랜치를 가져온 원격 커밋을 가리키도록 하려면 git fetch 다음에 git reset --hard <remote>/<branch>를 사용하세요. 이 reset은 추적 중인 파일의 스테이징된 변경 사항과 스테이징되지 않은 변경 사항을 버리지만, 일반적으로 관련 없는 추적되지 않는 파일까지 제거하지는 않습니다. 추적되지 않는 파일을 삭제하려면 별도로 git clean을 미리 확인하세요.

로컬 변경 사항을 보존할지 버릴지 결정하기

작업 방식을 선택하기 전에 git status --short로 상태를 확인하세요. git pull은 원격 커밋을 가져와 현재 브랜치에 통합합니다. 로컬 파일을 무조건 덮어쓰는 명령이 아닙니다. 로컬 편집 내용을 덮어쓰게 되거나 통합 과정에서 충돌이 발생하면 Git이 작업을 중단할 수 있습니다.

편집 내용을 보존해야 한다면 커밋하거나 stash에 보관하세요. 버려도 된다는 점을 확인했다면 현재 브랜치를 의도한 원격 추적 브랜치로 재설정하세요. 각 방법은 서로 다른 상태에 영향을 줍니다. stash는 커밋되지 않은 작업을 보관하고, 커밋은 작업을 이력에 기록하며, hard reset은 현재 브랜치를 이동시키고 추적 중인 파일을 재설정합니다.

git stash로 변경 사항을 임시 보관하기

업데이트하는 동안 작업 디렉터리를 깨끗한 상태로 만들고 나중에 편집 내용을 복원하려면 stash가 유용합니다. 추적되지 않는 파일도 포함하려면 -u를 사용하세요. 이 옵션이 없으면 일반적인 추적되지 않는 파일은 작업 디렉터리에 그대로 남습니다.

아래 로컬 예제는 작업 복사본을 업데이트하기 전에 추적 중인 파일의 편집 내용을 보관합니다. 임시 저장소를 만들고 완료 후 제거합니다. 이 글을 작성하는 단계에서는 예제를 실행하지 않았습니다.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

tmp=$(mktemp -d)
trap 'rm -rf "$tmp"' EXIT
cd "$tmp"
git init -q
git config user.name Example
git config user.email example@example.com
printf 'base\n' > note.txt
git add note.txt
git commit -qm 'base'
printf 'local edit\n' > note.txt
git stash push -u -m 'save local edit' -q
printf 'working copy: '
cat note.txt
git stash pop -q
printf 'restored edit: '
cat note.txt

실제 저장소에서는 git stash push -u -m "before pull"로 보관한 다음 git pull을 실행하세요. 보관한 작업은 git stash apply 또는 git stash pop으로 복원할 수 있습니다. apply는 stash 항목을 남기고, pop은 성공적으로 적용된 뒤 해당 항목을 제거합니다. 복원한 편집 내용과 새로 가져온 변경 사항이 충돌하면 파일을 해결하고, 항목을 삭제하기 전에 stash 목록을 확인하세요.

추적 중인 변경 사항을 버리고 원격 브랜치와 일치시키기

추적 중인 편집 내용을 버려도 된다고 확인한 경우에만 이 방법을 사용하세요. 원격 추적 참조를 가져온 뒤 특정 원격 브랜치로 재설정합니다. 예를 들어 git fetch origin 다음에 git reset --hard origin/main을 실행할 수 있습니다. origin과 main은 따라갈 원격 저장소와 브랜치 이름으로 바꾸세요. fetch는 참조를 업데이트하고, reset은 현재 브랜치를 해당 커밋으로 이동시키며 추적 중인 파일의 인덱스와 작업 디렉터리 내용을 그 상태로 바꿉니다.

hard reset은 추적되지 않거나 무시된 파일을 모두 정리하지는 않습니다. 추적되지 않는 파일이 추적 중인 경로에 파일을 쓰는 것을 막고 있다면 reset 과정에서 그 파일이 제거될 수 있으므로, 먼저 git status --short로 상태를 확인하세요. 브랜치가 더는 가리키지 않는 로컬 커밋은 새 브랜치 이력에 포함되지 않습니다. 해당 커밋을 보존해야 한다면 이 방법을 사용하지 마세요.

reset 전에 새 브랜치에 커밋을 보존하기

브랜치는 커밋을 가리키므로 현재 HEAD의 커밋 이력은 보존하지만, 커밋되지 않은 편집 내용은 저장하지 않습니다. 현재 커밋을 보존하려면 재설정 전에 git branch backup-before-reset처럼 브랜치를 만드세요. 남겨야 할 커밋되지 않은 편집 내용이 있다면 먼저 커밋하거나 stash에 보관하세요. 그런 다음 의도한 브랜치로 전환해 fetch와 reset 절차를 진행합니다. 필요하면 나중에 백업 브랜치의 커밋을 살펴보거나 병합할 수 있습니다.

필요할 때만 추적되지 않는 파일 제거하기

git clean은 추적되지 않는 파일을 삭제하며 git reset --hard와는 별개의 명령입니다. 삭제될 파일을 미리 보려면 git clean -n을 실행하고, 디렉터리까지 미리 보려면 git clean -nd를 사용하세요. 목록을 검토한 뒤 git clean -f는 추적되지 않는 파일을 삭제하고 git clean -fd는 추적되지 않는 디렉터리도 삭제합니다. 무시된 파일을 대상으로 하려면 추가 옵션이 필요합니다. -X는 무시된 파일만 대상으로 하고, -x는 무시된 파일을 다른 추적되지 않는 파일과 함께 포함합니다. 어느 옵션을 사용하든 먼저 미리 보기 결과를 검토하세요. 무시된 파일에 필요한 로컬 설정이나 생성 데이터가 들어 있을 수 있습니다.

git pull이 로컬 변경 사항을 처리하는 방식

git pull은 원격에서 가져온 뒤 설정된 병합 또는 rebase 방식으로 선택한 upstream을 현재 브랜치에 통합합니다. 로컬 편집 내용이 새로 들어오는 변경 사항과 겹치지 않으면 성공할 수 있지만, 충돌이 있거나 편집 내용이 덮어써질 상황이면 중단될 수 있습니다. 원격 버전으로 작업 디렉터리를 교체한다고 보장하지는 않습니다.

로컬 작업을 보존하려면 pull 전에 stash에 보관하거나 커밋한 뒤, 나중에 복원하거나 해당 커밋에서 이어서 작업하세요. 추적 중인 변경 사항을 버리고 특정 원격 브랜치와 일치시키려면 그 브랜치를 fetch한 다음 git reset --hard <remote>/<branch>를 사용하세요. 추적되지 않는 파일은 별도로 git clean 미리 보기를 검토한 경우에만 정리하세요.