# git describe

---

## 1. Git Describe란?

- `<span class="editor-theme-code">git describe</span>`<span style="white-space: pre-wrap;">는 현재 커밋(또는 ref)이 </span>****가장 가까운 태그****로부터 몇 번째 커밋인지, 어떤 커밋인지 요약해주는 명령어이다.
- <span style="white-space: pre-wrap;">주로 </span>****버전 관리****<span style="white-space: pre-wrap;">, </span>****릴리즈 스크립트 자동화****<span style="white-space: pre-wrap;">, </span>****디버깅 시 위치 파악****<span style="white-space: pre-wrap;"> 등에 활용됨.</span>

---

## 2. 기본 출력 형식

```text
<tag>_<N>_g<short-hash>
```

<table id="bkmrk-%ED%95%AD%EB%AA%A9%EC%84%A4%EB%AA%85%3Ctag%3E%EA%B0%80%EC%9E%A5-%EA%B0%80%EA%B9%8C%EC%9A%B4-%ED%83%9C%EA%B7%B8-%EC%9D%B4"><colgroup><col></col><col></col></colgroup><tbody><tr><th>항목

</th><th>설명

</th></tr><tr><td>`<span class="editor-theme-code"><tag></span>`

</td><td>가장 가까운 태그 이름

</td></tr><tr><td>`<span class="editor-theme-code"><N></span>`

</td><td>태그 이후 몇 번째 커밋인지 (0이면 태그 본인)

</td></tr><tr><td>`<span class="editor-theme-code">g<해시></span>`

</td><td>해당 커밋의 Git short hash

</td></tr></tbody></table>

---

## 3. 자주 쓰는 옵션

### <span style="white-space: pre-wrap;">3.1 </span>`<span class="editor-theme-code">--tags</span>`

```bash
git describe --tags
```

- <span style="white-space: pre-wrap;">기본 동작은 </span>****annotated tag****만 검색.
- `<span class="editor-theme-code">--tags</span>`<span style="white-space: pre-wrap;">를 붙이면 </span>****lightweight tag****도 포함하여 검색.

---

### <span style="white-space: pre-wrap;">3.2 </span>`<span class="editor-theme-code">--abbrev=0</span>`

```bash
git describe --abbrev=0
```

- 가장 가까운 태그 이름만 출력하고, 커밋 수나 해시는 생략됨.
- 릴리즈 버전명만 필요할 때 유용.

---

### <span style="white-space: pre-wrap;">3.3 </span>`<span class="editor-theme-code">--exact-match</span>`

```bash
git describe --exact-match
```

- <span style="white-space: pre-wrap;">현재 커밋이 태그와 </span>****정확히 일치****할 때만 태그 이름을 출력.
- 그렇지 않으면 아무 출력도 하지 않음.

---

## 4. 사용 예시

```bash
git describe                 # v2.0.0-2-gabc1234
git describe --tags         # lightweight 포함
git describe --abbrev=0     # v2.0.0
git describe --exact-match  # v2.0.0 (태그된 커밋일 때만)
```

---

## 5. 주의사항

- `<span class="editor-theme-code">git describe</span>`<span style="white-space: pre-wrap;">는 기본적으로 </span>****annotated tag****만 대상으로 함.
- <span style="white-space: pre-wrap;">lightweight 태그까지 포함하고 싶으면 </span>`<span class="editor-theme-code">--tags</span>`<span style="white-space: pre-wrap;"> 옵션 사용.</span>
- ****스크립트/자동화****<span style="white-space: pre-wrap;">에서는 보통 </span>`<span class="editor-theme-code">--tags --abbrev=0</span>`<span style="white-space: pre-wrap;"> 조합 사용.</span>
- 태그가 없는 경우, 결과가 출력되지 않거나 에러 발생 가능성 있음.

---