겪은 일: 내가 넣은 함수가 며칠 뒤 파일에서 사라졌는데, git 로그에는 내 커밋이 그대로 남아 있었습니다.
원인: 서버의 로컬 git 하나를 여러 작업 세션이 같이 쓰면서 각자 git add -A 로 커밋했고, 옛 사본을 들고 있던 쪽이 최신 수정을 덮었습니다.
이렇게 풀었다: 편집 전에 최신 파일을 읽고, 내가 만진 파일만 스테이징하고, 작업 뒤 마커 grep 과 git log -- 파일 로 살아 있는지 봅니다.
서버에서 바로 고치는 코드에 원격 저장소 없이 로컬 git 만 두는 경우가 있습니다. 되돌릴 지점이 생긴다는 장점이 크지만, 같은 저장소를 여러 작업자가 동시에 만지면 git 이 모든 것을 지켜 주지는 않습니다. 아래는 실제로 두 번 겪은 일입니다.
로컬 git 을 둔 이유
그 전까지는 파일을 고칠 때마다 .bak 사본을 남겼고, 그렇게 쌓인 것이 258개였습니다. 이를 대신하려고 서버 코드 폴더 두 곳에 로컬 git 을 만들었습니다. 원격 저장소는 일부러 두지 않았습니다. 비밀 값이 실수로 밖에 올라갈 위험과, 원격 인증에 기대는 부분을 없애려는 선택이었습니다.
.gitignore 에 넣은 것
.gitignore 에는 아래를 넣었습니다. 그 결과 .git 크기는 한쪽 2.4M, 다른 쪽 356K 로 작게 유지됐습니다.
venv/
__pycache__/
*.pyc
*.bak*
secrets/
*.env
.env
*.log
logs/
/_*.json
첫 번째: 며칠 뒤 사라진 함수 두 개
이미지 거르기 함수 두 개를 넣고 커밋해 두었습니다. 며칠 동안 다른 작업 세션이 같은 파일을 여러 번 다시 쓰며 다른 기능을 붙였습니다. 그 세션은 내 수정이 들어가기 전의 사본을 바탕으로 파일을 통째로 다시 썼고, git add -A && git commit 으로 올렸습니다.
끝까지 한 번 돌리는 시험에서 AttributeError 가 나서야 알았습니다. 함수 두 개가 파일에서 통째로 없어져 있었습니다. 최신 파일 위에 다시 넣고 다시 커밋해 복구했습니다.
두 번째: 42초 만에 덮인 수정
다른 날에는 한 파일을 정밀 치환 스크립트로 고쳤는데, 42초 뒤 다른 세션이 같은 파일을 자기 사본으로 통째 다시 썼습니다. 내가 넣은 함수 두 개가 사라졌고, 다른 파일은 그 함수를 계속 부르는 반쪽 상태가 됐습니다.
이번에는 복구가 쉬웠습니다. 파일을 통째로 올리지 않고 "이 문자열을 찾아 이렇게 바꾼다"는 치환 스크립트로 고쳤기 때문입니다. 상대가 바꾼 내용은 그대로 둔 채 내 블록만 최신 파일 위에 다시 얹고 바로 커밋해 복구 지점을 만들었습니다. 두 작업은 서로 다른 줄이라 충돌 없이 함께 남았습니다.
조상 확인이 YES 인데 내용이 없는 이유
처음에는 이렇게 확인했습니다.
git merge-base --is-ancestor <내 커밋> HEAD && echo YES
결과는 YES 였습니다. 내 커밋은 분명히 지금 HEAD 의 조상입니다. 하지만 이것은 "내 커밋이 역사에 있다"는 뜻일 뿐, "내 커밋이 바꾼 내용이 지금 파일에 남아 있다"는 뜻이 아닙니다. 뒤의 커밋이 그 파일을 옛 내용으로 다시 쓰면, 역사에는 내 커밋이 남고 파일에서는 내용이 지워집니다.
| 알고 싶은 것 | 명령 | 이것만으로 부족한 점 |
|---|---|---|
| 내 커밋이 역사에 있나 | git merge-base --is-ancestor |
내용이 남았는지는 모름 |
| 내 뒤에 누가 그 파일을 건드렸나 | git log --oneline -- 파일 |
무엇을 지웠는지는 따로 봐야 함 |
| 내 코드가 지금 파일에 있나 | grep -c 함수이름 파일 |
가장 확실함, 기대 개수를 알아야 함 |
살아 있는지 세는 명령
가장 확실한 확인은 내가 넣은 이름을 파일에서 세는 것입니다. 함수 하나를 넣었다면 정의 한 번과 호출 한 번, 그래서 2가 나와야 정상입니다. 0이면 지워진 것이고, 1이면 정의나 호출 중 하나가 빠진 반쪽 상태입니다.
grep -c "_reject_bad_images" app/image_filter.py # 2 가 정상
git log --oneline -- app/image_filter.py | head -n 5 # 내 커밋 뒤에 누가 있나
며칠에 걸친 작업이라면 다음 날 이어서 하기 전에 이 두 줄을 먼저 돌립니다.
지금 지키는 다섯 가지
- 편집하기 전에 git 에서 최신 파일을 읽고 그 위에 작업합니다. 내가 들고 있던 사본을 믿지 않습니다.
git add -A대신 내가 만진 파일만 스테이징합니다. 다른 세션이 아직 커밋하지 않은 작업을 쓸어 담지 않기 위해서입니다.- 같은 파일은 한 번에 한 세션만 만집니다. 어쩔 수 없으면 상대에게 지켜야 할 블록을 미리 알립니다.
- 파일 통째 올리기 대신 앵커를 한 번 확인하는 정밀 치환으로 고칩니다. 덮여도 다시 얹기 쉽습니다.
- 작업이 끝나면 마커 grep 과 파일별 로그로 내 코드가 남았는지 봅니다.
확인한 환경
| 항목 | 내용 |
|---|---|
| 서버 | 리눅스 서버, 원격 저장소 없는 로컬 git |
| 작업 방식 | 여러 작업 세션이 같은 저장소에서 git add -A && git commit |
| 겪은 날짜 | 2026년 7월 6일에서 9일(첫 번째), 7월 11일(두 번째) |
관련 글
정밀 치환 스크립트 자체가 사고를 내는 경우는 문자열 치환 패치 스크립트가 일으킨 세 가지 사고에 따로 적었습니다.
이 글의 내용은 2026년 10월 14일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.