Git 자주 쓰는 명령어 정리, 헷갈릴 때 먼저 보는 다섯 가지

Git 자주 쓰는 명령어 정리, 헷갈릴 때 먼저 보는 다섯 가지

Git은 자주 쓰는 명령어만 익혀도 절반은 끝납니다. 그런데 막상 터미널 앞에 서면 status부터 헷갈리고, checkout이랑 switch도 뒤섞이기 쉽죠. 저도 처음엔 그랬고, 직접 돌려보니 pull 방식 하나만 안 맞아도 바로 막히더라고요.

간단합니다.

그때는 몰랐는데, 자주 쓰는 명령어는 따로 있습니다. 오늘은 제가 실제로 써 보면서 정리한 흐름으로, 실수 줄이는 쪽에 맞춰 풀어볼게요.

이런 문제 있으신가요?

저장소를 건드렸는데 지금 뭐가 바뀌었는지 모르겠고, 커밋은 했는지 안 했는지도 헷갈릴 때가 있잖아요. 음, 그럴 땐 무작정 명령어를 외우는 것보다 흐름부터 잡는 게 훨씬 낫습니다.

제가 직접 테스트해보니, 서로 다른 시작점에서 만든 두 저장소를 git pull origin main 하자 바로 이런 메시지가 떴어요.

fatal: Need to specify how to reconcile divergent branches.

진짜 그랬어요. 그래서 바로 손대기보다, pull 방식을 먼저 정해 주는 게 맞다는 걸 다시 느꼈습니다. 스택오버플로우 답변에 따르면 이런 경우에는 git config pull.rebase true 같은 식으로 기준을 분명히 잡아 두는 편이 덜 헷갈립니다.
참고 링크: https://stackoverflow.com/questions/62653114/how-can-i-deal-with-this-git-warning-pulling-without-specifying-how-to-reconci

💡

핵심은 간단해요.
상태 확인, 변경 등록, 저장, 브랜치 이동, 파일 되돌리기.
이 다섯 개만 먼저 익혀도 Git이 훨씬 덜 무섭습니다.

원인 분석: 왜 이런 일이 생길까

공식 문서를 확인하면 git add는 새로 바뀐 내용을 올려 두는 역할이고, git commit은 그 상태를 저장하는 역할이에요.
반대로 git reset은 HEAD나 올려 둔 내용을 기준 상태로 맞추는 명령이라서, 손이 빠른 만큼 조심도 필요합니다.

또 하나. git checkout은 예전부터 오래 쓰였지만, 요즘은 git switch와 git restore로 역할이 나뉘어 있어요.
브랜치 바꾸는 일은 switch, 파일 되돌리는 일은 restore.
이렇게 갈라 놓으니 실수가 줄어들더라고요.

공식 설치 페이지에는 최신 버전이 2.55.0으로 표시돼 있고, 공식 문서도 그 기준으로 확인할 수 있어요. 버전이 바뀌면 세부 동작이 조금씩 달라질 수 있으니, 문서 버전 확인은 은근 중요합니다.

실전에서 바로 쓰는 팁

아래 다섯 개만 먼저 손에 익히면 됩니다. 복잡한 명령어보다 자주 쓰는 명령어가 먼저예요.

• git status
  지금 뭐가 바뀌었는지 봅니다. 제일 먼저 치면 돼요.
• git add 파일이름
  커밋할 내용을 올립니다. 한 번에 다 올릴 때는 git add .도 자주 써요.
• git commit -m "메시지"
  변경 내용을 저장합니다. 메시지는 짧고 분명하게 쓰는 게 좋아요.
• git switch 브랜치이름
  브랜치를 바꿉니다. 예전 checkout보다 의도가 더 또렷해요.
• git restore 파일이름
  파일을 이전 상태로 되돌립니다. 아차, 싶을 때 많이 씁니다.

아래처럼 외우면 편해요.

확인 → 올리기 → 저장 → 이동 → 되돌리기

공식 문서를 확인하면 git restore는 작업 트리 파일을 복원하고, --staged를 붙이면 올려 둔 내용도 다룰 수 있어요.
문서 링크: https://git-scm.com/docs/git-restore

브랜치 이동은 뭐가 더 나을까

항목	git switch	git checkout
주 용도	브랜치 이동	예전 통합 명령
헷갈림 정도	낮음	좀 높음
추천 상황	지금부터 새로 익힐 때	오래된 자료를 따라갈 때
한 줄 느낌	브랜치 전용	이것저것 다 하는 옛날 방식

저는 지금 새로 배우는 분이면 git switch를 먼저 권합니다.
이유는 단순해요. 덜 헷갈리거든요.
그리고 파일 되돌리기는 git restore, 기록 되돌리기는 git reset으로 나누면 머리가 훨씬 편합니다.

꼭 피해야 할 주의사항

git reset은 편하지만 세게 쓰면 되돌리기 까다로울 수 있어요.
특히 --hard는 작업 내용을 날릴 수 있으니, 습관처럼 치면 안 됩니다. 그러면 안 되죠.

또 git pull이 막혔다고 바로 강제 옵션부터 붙이는 것도 위험합니다.
먼저 내 브랜치와 원격 브랜치 상태를 확인하고, merge로 갈지 rebase로 갈지 정하는 게 안전해요.
공식 문서를 보면 git status로 상태를 보고, git reset으로 기준을 조절하고, git restore로 파일 단위 복원을 하는 흐름이 훨씬 안정적입니다.

돌이켜보면, Git은 어려운 도구라기보다 순서를 자꾸 잊게 만드는 도구에 가깝습니다.
순서만 잡히면 생각보다 단순해요.

마무리

오늘은 Git 자주 쓰는 명령어 정리를 해봤습니다.
핵심은 딱 다섯 가지예요. status, add, commit, switch, restore. 여기에 reset만 조심해서 붙이면 실수 확 줄어듭니다.
한 번에 다 외우지 말고, 오늘은 두 개만 손에 익혀 보세요. 내일 또 하나. 그게 제일 오래 갑니다.

끝까지 읽어주셔서 고맙습니다. 궁금한 점은 댓글로 알려주세요.
이 글이 조금이라도 도움이 됐다면 다음 글도 기대해 주세요.

자주 묻는 질문

Q. git switch와 git checkout은 뭐가 다른가요?
A. 둘 다 브랜치를 바꾸는 데 쓰이지만, git switch가 더 단순하고 의도가 분명합니다. 새로 익히기엔 switch가 더 편해요.

Q. git add는 꼭 해야 하나요?
A. 네, 보통은 필요합니다. 커밋할 내용을 먼저 올려 두는 단계라고 보면 됩니다.

Q. git restore는 언제 쓰면 되나요?
A. 작업한 파일을 이전 상태로 되돌리고 싶을 때 씁니다. 실수로 고친 내용을 취소할 때 유용해요.

Q. git reset은 무서운 명령어인가요?
A. 무서운 편입니다. 특히 --hard는 내용이 사라질 수 있어서, 꼭 필요한 경우에만 써야 해요.

Q. 처음 배우는 사람은 무엇부터 익히면 좋을까요?
A. git status부터입니다. 그다음 add, commit, switch, restore 순서로 가면 흐름이 잘 잡혀요.

#깃 #깃명령어 #깃정리 #개발팁 #터미널