Git과 GitHub: 기록하며 일하는 법
"최종_진짜최종_v3" 같은 파일 이름에서 벗어나, 바뀐 내용을 시점마다 기록하고 언제든 되돌리는 Git을 손에 익혀요. 작업 공간, 무대, 저장소의 세 공간, 좋은 커밋의 조건과 .gitignore, 브랜치와 충돌 해결, 상황별로 다른 되돌리기 방법(되돌려도 기록에 남는 비밀번호 이야기 포함), GitHub로 올리고 받고 함께 검토하는 흐름까지 실제 명령과 출력으로 따라가요.
보고서를 쓰다 보면 이런 파일들이 생겨요. 보고서.docx, 보고서_수정.docx, 보고서_최종.docx, 보고서_진짜최종_v3.docx. 어느 게 최신인지, 어제 지운 문단이 어느 파일에 있는지 헷갈리죠. 코드는 더 심해요. 하루에도 수십 번 바뀌고, 여러 사람이 같은 파일을 고쳐요.
Git은 이 문제를 푸는 도구예요. 파일을 고칠 때마다 사본을 만드는 대신, 바뀐 내용을 시점마다 기록해 두고 언제든 그 시점으로 돌아갈 수 있게 해 줘요. 개발자들이 거의 예외 없이 쓰는 도구라, 이 가이드북의 모든 트랙에서 계속 쓰여요.
Git과 GitHub
- Git은 내 컴퓨터에서 돌아가는 프로그램이에요. 기록을 만들고, 되돌리고, 갈래를 나누는 일을 해요. 인터넷 없이도 돼요.
- GitHub은 Git 저장소를 인터넷에 올려 두는 서비스예요. 백업이 되고, 다른 사람과 함께 작업하고, 코드를 검토하는 기능이 있어요. GitLab, Bitbucket 같은 비슷한 서비스도 있어요.
Git으로 할 수 있는 일은 이래요.
- 기록: 언제, 누가, 무엇을, 왜 바꿨는지 남아요.
- 되돌리기: 망가뜨려도 잘 되던 시점으로 돌아갈 수 있어요.
- 갈래 나누기: 원래 코드를 건드리지 않고 새 기능을 실험해요.
- 함께 일하기: 여러 사람의 변경을 합쳐요.
세 개의 공간
Git을 이해하는 열쇠는 세 개의 공간이에요.
- 작업 공간: 지금 내가 파일을 고치는 폴더예요.
- 무대(스테이징 영역): 다음 기록에 넣을 변경을 골라 올려 두는 곳이에요.
- 저장소: 기록(커밋)들이 차곡차곡 쌓이는 곳이에요. 폴더 안의 숨은
.git폴더예요.
단체 사진을 찍는다고 생각하면 쉬워요. 작업 공간은 사람들이 돌아다니는 방이고, git add로 사진에 나올 사람을 무대에 세우고, git commit으로 찰칵 찍어서 앨범(저장소)에 붙여요. 무대가 따로 있는 덕분에, 여러 파일을 고쳤어도 관련된 변경만 골라 하나의 기록으로 남길 수 있어요.
처음 한 번만: 설정
Git을 설치한 뒤, 기록에 남을 이름과 메일을 정해요. 공개 저장소에 올리면 이 정보가 공개되니, GitHub이 제공하는 대체 메일 주소를 써도 돼요.
git config --global user.name "내 이름"
git config --global user.email "[email protected]"
git config --global init.defaultBranch main
첫 저장소 만들기
공부 일기를 기록하는 작은 저장소를 만들어 볼게요. 아래 출력은 실제로 실행한 결과예요. 커밋마다 붙는 7자리 번호(해시)와 폴더 경로는 컴퓨터마다 달라요.
git init -b main diary # diary 폴더를 저장소로 만들어요
cd diary
echo "# 공부 일기" > README.md
git status # 지금 상태를 봐요
Initialized empty Git repository in /home/me/diary/.git/
On branch main
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
README.md
nothing added to commit but untracked files present (use "git add" to track)
git status는 가장 자주 쓰는 명령이에요. 지금 어느 갈래(main)에 있는지, 아직 기록이 없다는 것, 그리고 Git이 아직 지켜보지 않는(untracked) 파일 README.md가 있다는 걸 알려 줘요. 다음에 무엇을 하면 되는지(git add)도 친절하게 알려 줘요. **헷갈리면 일단 git status**를 쳐 보세요.
git add README.md # 무대에 올리고
git status --short # 짧게 보기
git commit -m "공부 일기 시작" # 찰칵
A README.md
[main (root-commit) f5ab034] 공부 일기 시작
1 file changed, 1 insertion(+)
create mode 100644 README.md
A는 새로 추가(Added)돼 무대에 오른 파일이라는 뜻이에요. 커밋이 만들어지고 f5ab034라는 번호를 받았어요. 이제 일기를 한 줄 써 볼게요.
echo "- 11월 16일: Git을 배웠다" >> README.md
git diff # 마지막 기록과 무엇이 달라졌나
diff --git a/README.md b/README.md
index 4b4cd77..8033a3e 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,2 @@
# 공부 일기
+- 11월 16일: Git을 배웠다
+로 시작하는 줄이 새로 생긴 줄이에요. 지운 줄은 -로 보여요. 커밋하기 전에 git diff로 내가 무엇을 바꿨는지 확인하는 습관이 실수를 크게 줄여요.
git commit -am "첫 기록 추가" # -a: 이미 지켜보는 파일의 변경은 add까지 한 번에
git log --oneline # 기록 보기
[main 9289aee] 첫 기록 추가
1 file changed, 1 insertion(+)
9289aee 첫 기록 추가
f5ab034 공부 일기 시작
좋은 커밋이란
커밋은 미래의 나와 동료에게 남기는 편지예요.
- 한 가지 목적만: "로그인 버그 수정"과 "버튼 색 변경"은 따로 커밋해요. 그래야 하나만 되돌릴 수 있어요.
- 작게, 자주: 하루 치를 한 번에 커밋하면 무엇이 문제를 일으켰는지 찾기 어려워요.
- 메시지는 무엇을, 왜: "수정", "ㅇㅇ" 대신 "로그인할 때 빈 비밀번호를 거절하도록 검사 추가"처럼 써요. 첫 줄은 짧게 요약하고, 더 설명할 게 있으면 한 줄 띄우고 본문에 적어요.
그리고 커밋하면 안 되는 것이 있어요.
- 비밀번호, API 키, 개인 정보: 한 번 기록되면 지워도 기록에 남아요(아래 되돌리기에서 확인해요).
- 자동으로 생기는 파일: 빌드 결과,
node_modules,__pycache__처럼 다시 만들 수 있는 것들이에요. - 아주 큰 파일: 동영상, 큰 데이터 파일은 저장소를 무겁게 만들어요. 필요하면 대용량 파일용 확장 기능(Git LFS)을 써요.
이런 파일은 저장소 맨 위에 .gitignore 파일을 만들어 Git이 아예 무시하게 해요.
# .gitignore
.env
__pycache__/
node_modules/
*.log
dist/
갈래 나누기: 브랜치
브랜치는 기록의 갈래예요. 새 기능을 만들거나 무언가를 실험할 때, main을 건드리지 않고 갈래를 하나 만들어 작업한 뒤 다 되면 합쳐요. 같은 줄을 두 갈래에서 다르게 고치면 어떻게 되는지 볼게요.
git switch -c title-change # 새 갈래를 만들고 옮겨 가요
# README.md의 제목을 "# 나의 공부 일기"로 고치고
git commit -am "제목 바꾸기"
git switch main # main으로 돌아와서
# 같은 줄을 "# 개발 공부 일기"로 고치고
git commit -am "제목에 개발 넣기"
git merge title-change # 합치기
Auto-merging README.md
CONFLICT (content): Merge conflict in README.md
Automatic merge failed; fix conflicts and then commit the result.
충돌이 났어요. 두 갈래가 같은 줄을 다르게 고쳐서, Git이 어느 쪽이 맞는지 정할 수 없는 거예요. 충돌은 오류가 아니라 사람의 판단이 필요하다는 신호예요. 파일을 열면 Git이 두 버전을 나란히 적어 놨어요.
<<<<<<< HEAD
# 개발 공부 일기
=======
# 나의 공부 일기
>>>>>>> title-change
- 11월 16일: Git을 배웠다
<<<<<<<과 ======= 사이가 지금 갈래(main)의 내용, =======과 >>>>>>> 사이가 합치려는 갈래의 내용이에요. 원하는 모양으로 직접 고치고(표시 줄은 지워요), 무대에 올려 커밋하면 충돌이 풀려요.
# README.md 첫 줄을 "# 나의 개발 공부 일기"로 고치고 표시 줄을 지운 뒤
git add README.md
git commit -m "제목 충돌 해결"
git log --oneline --graph
* 99674b0 제목 충돌 해결
|\
| * c90d2eb 제목 바꾸기
* | 82c8902 제목에 개발 넣기
|/
* 9289aee 첫 기록 추가
* f5ab034 공부 일기 시작
--graph로 보면 두 갈래가 나뉘었다가 합쳐진 모양이 보여요. 충돌을 줄이려면 갈래를 오래 끌지 말고 자주 합치고, 한 파일을 여러 사람이 동시에 크게 고치지 않게 일을 나눠요.
상황별 되돌리기
되돌리는 방법은 어디까지 갔는지에 따라 달라요.
| 상황 | 명령 | 결과 |
|---|---|---|
| 파일을 고쳤는데 마음에 안 들어요 (아직 add 전) | git restore 파일 | 마지막 기록의 내용으로 돌아가요. 고친 내용은 사라져요 |
| 무대에 올렸는데 내리고 싶어요 | git restore --staged 파일 | 무대에서만 내려요. 고친 내용은 그대로예요 |
| 방금 커밋의 메시지나 내용을 고치고 싶어요 (아직 공유 전) | git commit --amend | 마지막 커밋을 고쳐 다시 만들어요 |
| 이미 공유한 커밋을 취소하고 싶어요 | git revert 커밋번호 | 그 변경을 거꾸로 하는 새 커밋을 만들어요 |
echo "실수로 지운 줄" > README.md # 실수로 파일 내용을 덮어썼어요
git status --short
git restore README.md # 마지막 기록으로 되돌리기
cat README.md
M README.md
# 나의 개발 공부 일기
- 11월 16일: Git을 배웠다
M은 고쳐졌다(Modified)는 뜻이에요. git restore로 마지막 기록의 내용이 돌아왔어요. 이번에는 커밋까지 해 버린 실수를 되돌려 볼게요. 일기에 비밀번호를 적어 커밋해 버렸어요.
echo "- 11월 17일: 비밀번호는 1234" >> README.md
git commit -am "17일 기록"
git revert --no-edit HEAD # 마지막 커밋을 취소하는 새 커밋
git log --oneline -3
[main 496dbda] Revert "17일 기록"
1 file changed, 1 deletion(-)
496dbda Revert "17일 기록"
0624bb7 17일 기록
99674b0 제목 충돌 해결
파일에서는 비밀번호 줄이 사라졌어요. 그런데 기록을 보세요. 0624bb7 커밋이 그대로 남아 있어요. git revert는 기록을 지우지 않고 "취소했다"는 기록을 하나 더 쌓는 방식이라, 그 커밋을 열어 보면 누구나 비밀번호를 볼 수 있어요. 기록을 통째로 고쳐 쓰는 방법도 있지만, 이미 GitHub에 올렸다면 누군가 복사해 갔을 수 있어요. 그래서 비밀번호나 API 키를 커밋했다면 기록을 지우는 것보다 먼저, 그 비밀번호와 키를 바로 바꾸거나 폐기해야 해요.
한 가지 더 조심할 명령이 git reset --hard예요. 저장하지 않은 변경까지 한꺼번에 지워서, 잘못 쓰면 몇 시간의 작업이 사라져요. 정말 망쳤다 싶을 때는 Git이 최근에 머물렀던 지점들을 기억하는 git reflog로 살릴 수 있는 경우가 많으니, 당황해서 더 지우기 전에 먼저 확인해 보세요.
GitHub과 함께 쓰기
GitHub에 저장소를 만들면 내 저장소와 연결할 원격 저장소 주소가 생겨요. 보통 origin이라는 이름으로 연결해요.
git remote add origin https://github.com/내아이디/diary.git
git push -u origin main # 내 기록을 원격으로 올리기 (-u: 다음부터는 git push만)
git pull # 원격의 새 기록을 받아 합치기
git clone https://github.com/누군가/프로젝트.git # 남의 저장소 전체를 받아 오기
GitHub은 2021년부터 Git 명령에서 계정 비밀번호를 받지 않아요. 비밀번호 대신 개인 액세스 토큰을 쓰거나, SSH 키를 등록해서 인증해요. 토큰도 비밀번호와 같으니 코드에 적지 않아요.
함께 일하는 흐름: 풀 리퀘스트
여러 사람이 일할 때는 main에 바로 올리지 않고 풀 리퀘스트(PR)를 거쳐요.
- 갈래를 만들어 작업하고 커밋해요.
- 그 갈래를 GitHub에 올려요(
git push -u origin 갈래이름). - GitHub에서 "이 갈래를 main에 합쳐 주세요"라는 풀 리퀘스트를 열고, 무엇을 왜 바꿨는지 설명을 써요.
- 동료가 코드를 검토하고 의견을 남겨요. 고칠 게 있으면 같은 갈래에 커밋을 더해요.
- 검토가 끝나면 합쳐요.
풀 리퀘스트는 작을수록 검토가 빠르고 정확해요. 검토할 때는 사람이 아니라 코드에 대해 말하고, "왜 이렇게 했어요?"처럼 질문으로 의견을 전하면 좋아요.
여럿이 쓰는 갈래에는 git push --force를 쓰지 않아요. 남이 올린 기록을 덮어써서 지워 버릴 수 있거든요.
하루의 작업 흐름
git pull로 최신 상태를 받아요.git switch -c 작업이름으로 갈래를 만들어요.- 고치고,
git status와git diff로 확인하고,git add와git commit을 작게 자주 해요. git push로 올리고 풀 리퀘스트를 열어요.- 합쳐지면
git switch main과git pull로 돌아와요.
실습
- 아무 폴더에서
git init을 하고, 파일 세 개를 만들어 그중 두 개만 골라 커밋해 보세요.git status가 나머지 하나를 어떻게 보여 주나요? .gitignore에*.log를 넣고test.log파일을 만들어 보세요.git status에 나오나요?- 일부러 충돌을 만들고, 두 쪽 내용을 모두 살리는 방향으로 풀어 보세요.
git log --oneline --graph --all로 모든 갈래의 모양을 보세요.- GitHub에 빈 저장소를 만들고 연습 저장소를 올려 보세요. 웹에서 커밋 기록과 변경 내용이 어떻게 보이나요?
자주 하는 실수
- 비밀번호와 키를 커밋하기. 지워도 기록에 남아요.
.gitignore로 막고, 새었다면 바로 바꿔요. - "수정" 같은 메시지 쓰기. 나중에 기록이 아무것도 알려 주지 않아요.
- 하루 치를 한 커밋에 몰아넣기. 되돌리기도, 원인 찾기도 어려워져요.
- 커밋 전에
git diff를 안 보기. 의도하지 않은 변경이 섞여 들어가요. - 공유한 기록을 고쳐 쓰기.
--amend나 강제 푸시는 아직 올리지 않은 기록에만 써요. 공유한 건revert로 되돌려요. - 충돌을 무서워하기. 표시를 읽고 원하는 대로 고치면 끝이에요.
점검 문제
- Git의 세 공간은 무엇이고,
git add와git commit은 각각 무엇을 하나요? git status --short에서A와M은 무슨 뜻인가요?- 좋은 커밋의 조건 세 가지는?
- 충돌은 왜 생기고, 어떻게 푸나요?
- 아직 add하지 않은 변경을 버리는 명령과, 이미 공유한 커밋을 취소하는 명령은?
- 비밀번호를 커밋한 뒤
git revert로 되돌렸어요. 이제 안전한가요? - 여럿이 쓰는 갈래에 강제 푸시를 하면 안 되는 이유는?
정답
- 작업 공간, 무대, 저장소예요.
git add는 변경을 무대에 올리고,git commit은 무대의 내용을 하나의 기록으로 저장소에 남겨요. A는 새로 추가돼 무대에 오른 파일,M은 고쳐진 파일이에요.- 한 가지 목적만 담고, 작게 자주 하고, 무엇을 왜 바꿨는지 메시지에 쓰는 거예요.
- 두 갈래가 같은 곳을 다르게 고쳐서 Git이 어느 쪽이 맞는지 정할 수 없을 때 생겨요. 표시된 두 내용을 보고 원하는 모양으로 고친 뒤, 표시 줄을 지우고 add와 commit을 해요.
git restore 파일과git revert 커밋번호예요.- 아니에요. revert는 취소하는 새 커밋을 더할 뿐이라 원래 커밋에 비밀번호가 남아 있어요. 비밀번호를 바로 바꿔야 해요.
- 다른 사람이 올린 기록을 덮어써서 지워 버릴 수 있기 때문이에요.
다음 강의
기록을 남기는 법을 익혔으니, 이제 코드가 말을 안 들을 때 원인을 찾는 법을 배울 차례예요. 다음 강의에서는 추측 대신 증거로 버그를 잡는 디버깅의 기술을 다뤄요. Git의 기록도 버그가 언제 생겼는지 찾는 강력한 증거가 돼요.