Git & GitHub #5 - Git 구조 및 명령어 & Git 트러블 슈팅

 

git commit -m "Blog Posting #5🫡"
개발자협업의 필수 도구

 

---

Git 구조: 로컬 Git의 영역 파악

Git에서 코드의 변경 사항은 여러가지 영역을 거친다.

Git은 코드의 상태를 여러 단계로 나누어 관리한다. 여기서는 4개의 주요 영역을 중심으로 설명할 예정이다.

 

1. Working Directory(작업공간):

• 로컬에서 실제로 작업을 수행하는 공간. 이곳에서 파일을 수정, 삭제, 추가하는 등의 작업이 이루어진다.
  • 로컬 작업공간에서 작업할 브랜치 선택 → `git checkout`
• Tracked: Git이 추적하는 파일 → 이전에 Git에 추가된 파일들.
• Untracked: Git이 아직 추적하지 않은 파일 → 새로 생성된 파일 또는 수정된 파일들의 집합
  • 이 중에서 Commit 하고자하는 것을을 Staging Area로 올린다.

2. Staging Area, Index:

• 커밋을 위해 대기 중인 파일들이 저장되는 영역 → `git add`
  • Git Commit 명령어 시 여기에 있는 파일들이 Commit 된다(스냅샷 찍힘)
  • Cache = Index = Stage 또는 Cached = Indexed = Staged
• Staged: Staging Area에 있는 파일들은 커밋될 준비가 된 상태이다.

3. Unstaged:

• Git이 추적히는 파일 중에서 수정되었지만 아직 Stating Area로 올리지 않은 파일들.
• 이 상태의 파일들은 아직 커밋되지 않았기 때문에 커밋하려면 `git add` 명령어로 Staging Area로 올려야한다.

4. Untracked:

• Git이 아직 추적하지 않은 파일들. 새로 생성된 파일이 여기에 해당하며 이 상태의 파일들은 Git이 전혀 관리하지 않는다.

 

 

• Untracked: 워킹 디렉토리에 추가되었지만 Git에서 관리하지 않는 상태
• Unmodified: 신규로 파일이 추가되었을 때의 상태로 new file 상태와 동일
• Modified: 파일이 추가된 이후 해당 파일이 수정되었을 때의 상태
• Staged: Git 스테이징 영역에 반영 된 상태

 

기본적인 Git 작업 명령어: 브랜치 및 파일 관리

브랜치 관리

• `git fetch -p`: 원격 브랜치를 로컬로 가져온다.
• `git pull origin main`: 원격 main 브랜치의 최신 커밋들을 로컬로 가져온다 (Pull + Merge)
• `git branch -a`: 원격 브랜치와 로컬 브랜치 리스트를 조회
• `git checkout [브랜치명]`: 해당 로컬 브랜치 이동
• `git checkout -b [새 브랜치명]`: 로컬 브랜치 생성(현재 위치하고있는 브랜치와 커밋을 기준으로)
• `git merge [브랜치명]`:현재 브랜치에 다른 브랜치의 변경사항을 머지한다.
• `git branch --delete` 또는 `git branch -D`: 로컬 브랜치 삭제

---

파일 관리

• `git add [파일명]`: Git 커밋에 수정 사항으로 등록하기 위한 예비 절차. 파일을 Staging Area에 추가하여 커밋할 준비.
  • Staged ←Unstaged: Git이 추적중인 파일의 변경사항
  • Staged ←Untracked: Git이 모르는(추적되지 않아 몰랐던) 파일의 추가
• `git add .`: 현재 디렉토리의 모든 변경 사항을 Staging Area에 추가
• `git add -p`: 파일 단위의 추가가 아닌 텍스트 단위의 추가
• `git rm [파일명]`: 파일을 Git에서 삭제하고 Staging Area에 반영
• `git mv [기존 파일명] [새 파일명]`: 파일을 이동하거나 이름을 변경하고 Staging Area에 반영

---

파일 수정내용 임시 저장소:  Stash

• `git stash`: 현재 `git add`를 통해 Commit 대기중인 모든 수정사항들 임시로 저장
• `git stash pop`: 임시 저장소에 저장되어있는 것 중 가장 최신의 하나를 꺼낸다.(Stack 자료구조)
• `git stash list`: 저장된 Stash 목록 조회(Stack 자료구조에 쌓여있는 임시 저장본 리스트)

---

커밋 생성 및 수정

• `git commit`: 에디터를 통해 메세지를 입력하여 커밋(일반적으로는 `vi`사용, 커스텀 시 `code`사용 가능)
• `git commit -m "메시지"`: 입력한 메세지를 통해 커밋
• `git commit -am "메세지"`: `git commit -a` (Untracked 제외) + `git commit -m "메세지"`
• `git commit --amend`: 마지막 커밋 수정(커밋 메세지 수정 or 커밋 내용 추가)
• `git push`: 현재 브랜치에 커밋된 내용 모두 원격에 업로드(푸시)
• `git push --set-upstream origin main`: 로컬 브랜치에 연결된 원격 브랜치가 없을 때 최초 연결

---

커밋 삭제(롤백)

• git reset [옵션] HEAD~1: 최근 커밋을 취소하고 롤백
  • `--soft`: 커밋만 취소하고 Staging Area는 유지한다.
  • `--mixed`: 커밋을 취소하고, Staging Area에서 변경 사항을 Unstaged로 이동한다
  • `--hard`: 커밋과 작업 디렉토리의 변경 사항을 모두 취소한다.
• 절대 커밋 지칭 Hash: `2cd~~`
• 상대 커밋 지칭 Relative References (^rhk ~) : `HEAD~1` 혹은 `HEAD^1`
  • ~(Tilde): N번째 조상 - 수직
  • ^(Caret):N번째 부모 - 수평
  • @(At-Sign): Reflog 내가 직접 커밋한 히스토리 기반의 롤백

---

커밋 조회

• `git log`: 커밋 메세지 기반 조회
• `git show`: 커밋 메세지 + 상세 수정내용 기반 조회

---

몇 가지 에러 혹은 경고 메세지

warning: in the working copy of 'detail.html', LF will be replaced by CRLF the next time Git touches it.
warning: in the working copy of 'simple.html', LF will be replaced by CRLF the next time Git touches it.

 

• CRLF/LF 경고: 윈도우와 리눅스/맥OS 간의 줄바꿈 문자(CRLF/LF)차이로 인해 발생하는 경고
  • 해결:
    • 윈도우: `git config --global core.autocrlf true`
    • 리눅스/맥: `git config --global core.autocrlf input`

---

Git 트러블 슈팅: 이전 Commit 수정

Git 작업 중 실수를 하거나 이전 커밋으로 수정해야 하는 경우, 여러 가지 방법으로 문제를 해결 할 수 있다.

Amend / Reset - 단일 문제 발생 시

1. Amend: 

• `git commit --amend` 명령어를 사용하여 직전 커밋의 메세지나 내용을 수정할 수 있음.
• 간단한 수정이나 실수로 빠뜨린 내용을 추가할 때 유용하다.

2. Reset:

• `git reset HEAD~1` 명령어를 사용하여 직전 커밋을 롤백할 수 있음.
• Cherry-Picking 불가능: 예) `git reset HEAD~3`: 3번째 전으로 3개의 커밋 모두 롤백
• 세 가지 옵션이 있다. 커밋을 어떻게 롤백할지 선택 가능
  • `--soft`: 커밋만 취소하고 Staging Area는 유지한다.
  • `--mixed`(기본값): 커밋을 취소하고 Staging Aread에서 Unstaged로 이동
  • `--hard`: 커밋과 모든 변경 사항을 취소하고 작업 디렉토리를 초기상태로 되돌린다.

Rebase - 다수 문제 발생 시

• Rebase 명령어를 사용하여 여러 개의 커밋을 다시 정리할 수 있다.
  • `git rebase -i HEAD~3` 명령어로 이전 커밋들을 편집, 삭제, 합치기 등의 작업을 수행할 수 있다.
  • Rebase 옵션:
    • Reword: 커밋 메세지 수정
    • Edit: 커밋 내용 수정 및 충돌 해결
    • Drop: 커밋제거
    • Squash: 불필요하게 많아진 커밋의 수를 줄이기 위해 커밋 합치기\

※ Cherry-Picking(체리피킹): '케이크 위에 얹어져있는 체리만 집어먹는 행위' → 원하는 결과나 데이터만 선택적으로 골라 사용하는 행위

Reflog - 작업 복구

• Reflog 명령어를 사용하여 이전에 수행했던 모든 작업을 조회하고, 특정 시점으로 돌아갈 수 있다.
  • `git reflog` 명령어를 사용하여 과거의 상태로 복구할 수 있다.
  • 수행하는 모든 커밋들은 저장되어 어떤 치명적인 문제가 발생해도 대응가능.
  • `HEAD@{n}` 형태로 원하는 시점으로 이동할 수 있으며 실수로 브랜치를 삭제했거나 커밋을 잃어버렸을대 유용하다.

 

 

---

 

ℹ️참고

[ASAC 6기 강의자료]

https://cornswrold.tistory.com/71#google_vignette

[Git] 형상관리와 Git (3편) - Git 스테이징 단계 이해

https://git-scm.com/book/ko/v2/Git%EC%9D%98-%EA%B8%B0%EC%B4%88-%EC%88%98%EC%A0%95%ED%95%98%EA%B3%A0-%EC%A0%80%EC%9E%A5%EC%86%8C%EC%97%90-%EC%A0%80%EC%9E%A5%ED%95%98%EA%B8%B0

Git - 수정하고 저장소에 저장하기