Husky - 커밋/푸시 전 작업 실행하기

📌Git Hooks란?

Git이 특정 이벤트(커밋, 푸시 등) 발생 시 자동으로 실행하는 스크립트.

.git/hooks/ 폴더에 위치하지만 — .git/은 git이 추적하지 않으므로 팀원과 공유 불가. 이 문제를 해결하는 게 Husky.

 

📌Husky란?

Git hooks를 프로젝트 폴더 내부(.husky/)에 두고 버전 관리·팀 공유를 가능하게 해주는 라이브러리.

 

동작 원리

1. npm install 시 prepare 스크립트로 husky install 실행
2. Husky가 git config core.hooksPath .husky를 설정 — git이 .git/hooks/ 대신 .husky/를 보게 만듬
3. .husky/pre-commit, .husky/pre-push 등을 만들면 git이 해당 시점에 자동 실행

 

설치

npm install --save-dev husky
npx husky init   # .husky/ 폴더 생성 + package.json에 prepare 스크립트 추가

 

 

훅 추가

echo "npm test" > .husky/pre-commit

 

📌주요 훅: pre-commit vs pre-push

pre-commit

• 시점: git commit 실행 시, 커밋이 만들어지기 직전
• 실패하면: 커밋 자체가 만들어지지 않음
• 용도: 빠르고 가벼운 검증 — 스테이징된 파일에 대한 lint·format·타입 체크
• 주의: 모든 커밋마다 실행되므로 느리면 개발 생산성 저하. 보통 lint-staged와 조합해 변경된 파일만 검사

# .husky/pre-commit
npx lint-staged

 

pre-push

• 시점: git push 실행 시, 원격으로 보내기 직전
• 실패하면: 푸시가 막힘 (로컬 커밋은 그대로 유지)
• 용도: 무거운 검증 — 전체 테스트, 빌드, 보안 스캔
• 장점: 커밋은 자유롭게 하되, 원격에 망가진 코드가 올라가는 건 방지

# .husky/pre-push
npm run build:prod
npm test

 

차이 비교

  

항목	pre-commit	pre-push
적합한 작업	가벼움 (lint, format)	무거움 (build, test)
우회	git commit --no-verify	git push --no-verify

 

실전 권장 패턴

• pre-commit: lint-staged로 변경 파일만 빠르게 검사 (1-2초)
• pre-push: 전체 테스트·빌드 (수십 초~분)
• commit-msg: 커밋 메시지 컨벤션 검증 (commitlint)

 

주의사항

• --no-verify로 우회 가능하므로 CI에서도 동일 검증을 돌려야 함 (훅은 1차 방어선일 뿐)
• 팀원이 npm install 안 하면 훅 미작동 — README에 명시 필요
• Windows에서 줄바꿈(LF/CRLF) 이슈로 훅이 안 돌 수 있음 → .gitattributes로 LF 강제