# Detached HEAD 상태

## 개요

Git은 분산 버전 관리 시스템(DVCS)로서, 소트웨어 개발 과정에서 코드의 변경 이력을 체계적으로 추적하고 관리할 수 있게 해줍니다. Git을 사용하다 보면 가끔 **Detached HEAD 상태**(분리된 HEAD 상태)라는 메시지를 마주할 수 있습니다. 이 상태는 Git에서 흔히 발생하는 개념이지만, 초보자에게는 혼란스럽고 실수로 인한 데이터 손실을 초래할 수 있는 상황입니다.

이 문서는 Detached HEAD 상태의 정의, 발생 원인, 영향, 그리고 이를 해결하는 방법까지 체계적으로 설명하여, 사용자가 안전하게 Git을 다룰 수 있도록 돕는 것을 목표로 합니다.

---

## Detached HEAD 상태란?

Git에서 **HEAD**는 현재 작업 중인 커밋(commit)을 가리키는 특수한 참조(reference)입니다. 일반적으로 HEAD는 현재 체크아웃(checkout)된 브랜치의 최신 커밋을 가리킵니다. 예를 들어, `main` 브랜치에 있다면 HEAD는 `main` 브랜치의 가장 최근 커밋을 가리킵니다.

반면, **Detached HEAD 상태**는 HEAD가 특정 브랜치가 아닌, 하나의 커밋에 직접 연결된 상태를 의미합니다. 이는 즉, 현재 어떤 브랜치에도 속하지 않고, 특정 커밋의 상태에서 작업을 하고 있다는 뜻입니다.

### 발생 시나리오 예시

```bash
$ git checkout abc1234
Note: switching to 'abc1234'.

You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches on your repository.
```

이 메시지는 특정 커밋 해시(`abc1234`)로 체크아웃했을 때 나타납니다.

---

## Detached HEAD 상태가 발생하는 원인

Detached HEAD 상태는 주로 다음과 같은 상황에서 발생합니다.

### 1. 특정 커밋으로 체크아웃할 때

```bash
git checkout <commit-hash>
```

이 명령은 특정 커밋의 상태로 이동하므로, 브랜치가 아닌 커밋을 직접 가리키게 되어 HEAD가 분리됩니다.

### 2. 브랜치의 이전 상태를 확인할 때

```bash
git checkout HEAD~3
```

이 명령은 현재 HEAD에서 세 단계 이전의 커밋으로 이동합니다. 이 역시 브랜치를 벗어나므로 Detached HEAD 상태가 됩니다.

### 3. 원격 브랜치를 직접 체크아웃할 때 (Git 2.23 이전)

```bash
git checkout origin/main
```

이 경우에도 HEAD가 원격 브랜치의 커밋을 가리키게 되어 분리 상태가 됩니다.

---

## Detached HEAD 상태의 영향

Detached HEAD 상태에서의 작업은 다음과 같은 특징을 가집니다:

- **새 커밋이 생성되지만 브랜치에 연결되지 않음**: 이 상태에서 `git commit`을 하면 새로운 커밋은 생성되지만, 어떤 브랜치에도 포함되지 않습니다.
- **브랜치가 없기 때문에 커밋이 쉽게 유실될 수 있음**: 이 커밋들은 "고아 커밋(orphan commit)"이 되며, 브랜치나 태그로 참조하지 않으면 나중에 찾기 어려워집니다.
- **HEAD가 이동하지 않음**: 새로운 커밋이 생성되더라도, 이전 브랜치(예: main)는 그대로 유지됩니다.

> ⚠️ 주의: Detached HEAD 상태에서 생성한 커밋은 추후 브랜치로 연결하지 않으면 `git gc`(가비지 컬렉션)에 의해 삭제될 수 있습니다.

---

## 해결 방법 및 권장 사례

### 1. 기존 브랜치로 돌아가기

가장 간단한 방법은 원래 작업하던 브랜치로 돌아가는 것입니다.

```bash
git checkout main
```

또는 Git 2.23 이상에서는 `switch` 명령을 사용할 수 있습니다:

```bash
git switch main
```

### 2. 새로운 브랜치 생성하여 커밋 보존

Detached HEAD 상태에서 작업한 내용을 보존하고 싶다면, 새로운 브랜치를 생성해야 합니다.

```bash
git switch -c new-feature
```

이 명령은 현재 커밋을 기준으로 `new-feature`라는 새 브랜치를 만들고, HEAD를 그 브랜치에 연결합니다. 이후의 커밋은 정상적으로 브랜치에 포함됩니다.

### 3. 기존 브랜치에 커밋 병합

Detached HEAD 상태에서 만든 커밋을 기존 브랜치에 반영하고 싶다면, 다음과 같이 처리할 수 있습니다:

```bash
git checkout main
git merge abc1234  # Detached 상태에서 만든 커밋의 해시
```

또는 `cherry-pick`을 사용해 특정 커밋만 선택적으로 가져올 수도 있습니다.

```bash
git cherry-pick abc1234
```

---

## 예방 및 모범 사례

- **특정 커밋을 확인할 땐 읽기 전용으로 사용**: `git show <commit>` 또는 `git log` 명령을 활용하여 코드를 확인하고, 불필요하게 체크아웃하지 않도록 합니다.
- **작업이 필요한 경우 브랜치를 생성**: 이전 커밋에서 작업을 해야 한다면, 즉시 새 브랜치를 생성해 안전하게 작업합니다.
- **Git의 안내 메시지를 주의 깊게 읽기**: Detached HEAD 상태 진입 시 Git은 경고 메시지를 제공하므로 이를 무시하지 말아야 합니다.

---

## 참고 자료

- [Git 공식 문서 - git-checkout](https://git-scm.com/docs/git-checkout)
- [Git 공식 문서 - git-switch](https://git-scm.com/docs/git-switch)
- Pro Git 책 (Scott Chacon, Ben Straub) - Chapter 3: Git 브랜치

---

## 관련 문서

- [Git 브랜치 관리](/wiki/Git-브랜치-관리)
- [Git 커밋 해시](/wiki/Git-커밋-해시)
- [Git의 HEAD란?](/wiki/Git-HEAD)

Detached HEAD 상태는 Git의 강력한 기능 중 하나인 커밋 기반 작업 방식의 자연스러운 결과입니다. 이를 정확히 이해하고 적절히 대응함으로써, 개발자는 보다 유연하고 안전하게 코드 기록을 탐색하고 관리할 수 있습니다.