Git hook이란 무엇이며 어떻게 사용되나요?

Question

Accepted Answer

**Git hook**은 Git이 Git 워크플로의 특정 지점(commit, push, merge 전후 등)에서 **자동으로** 실행하는 스크립트입니다. 자동화 — 표준 강제, 검사 실행, 동작 트리거 — 를 가능하게 하며, 코드 품질과 CI 통합에 널리 사용됩니다.

## hook이란

```text
hook은 .git/hooks/(또는 도구로 관리)에 있는 실행 가능한 스크립트로, Git이 이벤트에 실행:
  클라이언트 측(로컬):
    pre-commit   → commit 생성 전(린트, 포맷, 빠른 테스트 실행)
    commit-msg   → commit 메시지 검증/포맷
    pre-push     → push 전(테스트 실행, 깨진 코드 push 방지)
    post-merge/checkout → merge/checkout 후(예: 의존성 재설치)
  서버 측(remote에서):
    pre-receive / update → push 시 정책 강제(나쁜 push 거부)
    post-receive → push 후 배포/CI/알림 트리거
```

## 일반적인 용도

```text
✓ pre-commit → 코드 LINT 및 FORMAT; 빠른 테스트 실행; 비밀/디버그 코드 차단
  → commit되기 전에 문제를 잡음(빠른 피드백, 일관된 품질)
✓ commit-msg → 메시지 형식 강제(예: Conventional Commits)
✓ pre-push → 테스트 스위트 실행 → 실패하는 코드 push 안 함
✓ 서버 측 → 정책 강제; CI/CD와 배포 트리거
```

## 팀에서 hook 관리하기

```text
⚠️ .git/hooks/는 로컬이며 commit되지 않음 → hook이 자동 공유되지 않음.
팀 전체에 hook을 공유하려면 도구 사용:
  → HUSKY(JS 생태계), pre-commit(Python 프레임워크), lefthook 등
  → 이것들이 hook을 repo에 버전 관리하고 모두에게 설치
→ CI와 결합: hook은 빠른 로컬 피드백; CI는 강제된 안전망
  (hook은 --no-verify로 우회 가능하므로, CI도 강제해야 함).
```

## 왜 중요한가

Git hook을 이해하는 것은 **품질 검사와 워크플로 동작을 자동화하는 데** 가치 있는 시니어 수준의 지식이므로, 코드 품질을 유지하고 CI/CD와 통합하는 데 유용합니다.

hook은 **핵심 Git 이벤트에서 자동화** — commit, push, merge 전후 등에 스크립트를 자동 실행 — 를 가능하게 하며, 표준을 강제하고 문제를 일찍 잡는 데 널리 사용됩니다.

가장 일반적이고 가치 있는 용도는 **코드가 commit되기 전에 린팅, 포맷팅, 빠른 테스트, 비밀 감지를 실행**하는 **pre-commit hook**입니다 — 빠른 피드백을 제공하고 일관된 품질을 자동으로 보장하여(문제가 나중에 CI나 리뷰에서가 아니라 commit 시점에 잡힘) 매우 인기 있는 관행입니다.

다른 용도(Conventional Commits 같은 메시지 관례를 강제하는 commit-msg hook, 깨진 코드 push를 방지하기 위해 테스트를 실행하는 pre-push hook, 정책을 강제하거나 CI/CD와 배포를 트리거하는 서버 측 hook)는 자동화를 워크플로 전반으로 확장합니다.

실무적인 **팀 관리** 측면을 이해하는 것이 중요합니다. `.git/hooks/`는 로컬이며 **commit되지 않으므로**, hook이 자동 공유되지 않습니다 — 팀 전체에 공유하려면 hook을 repo에 버전 관리하고 모두에게 설치하는 **Husky, pre-commit, lefthook** 같은 도구가 필요합니다.

결정적으로, hook이 **우회 가능**(`--no-verify`)하다는 점을 이해하는 것은 이것이 빠른 *로컬* 피드백을 제공하지만 **CI도 검사를 강제**해야 진짜 안전망이라는 의미입니다 — 심층 방어에 대한 핵심 통찰(속도를 위한 로컬 hook, 강제를 위한 CI)입니다.

품질 검사와 워크플로 동작을 자동화하면 코드 품질과 일관성이 향상되고, Git hook(특히 로컬 검사를 위한 pre-commit, 도구로 관리되고 CI로 보완됨)이 이를 위한 널리 사용되는 메커니즘이므로, Git hook을 이해하는 것 — 무엇인지, 일반적인 용도, 도구를 통한 팀 관리, CI와의 관계 — 은 자동화되고 품질에 집중한 개발 워크플로를 구축하기 위한 가치 있는 시니어 수준의 지식으로, 전문 팀에서 품질을 유지하는 데 사용되는 관행을 반영합니다.