「커밋 전에 black·linter·테스트를 돌려라」를 사람이 매번 기억할 순 없습니다.

pre-commit이 git hook으로 「커밋할 때 자동 실행」해 줍니다.

잘못된 코드는 커밋 자체가 거부.

기본 설정.

pip install pre-commit.

.pre-commit-config.yaml 작성.

예: repos: - repo: https://github.com/psf/black, rev: 23.0.0, hooks: - id: black.

pre-commit install로 git hook 등록.

이후 자동.

git commit 할 때마다 등록된 도구가 모두 실행 → 한 가지라도 실패하면 커밋 거부.

자동 수정 가능한 도구(black 등)는 파일을 자동 수정 → 다시 git add → 커밋.

흔한 hook들.

black·isort·ruff(포맷·lint), mypy(타입 검사), trailing-whitespace·end-of-file-fixer(공백 정리), check-yaml·check-json(파일 형식 검증), detect-private-key(비밀키 누출 방지).

CI와의 관계.

pre-commit이 첫 방어선, CI가 두 번째.

pre-commit ci 같은 봇으로 PR에서도 자동 실행 → 누군가가 install 안 해도 안전.

「로컬에서 잡히면 빠름, 안 잡혀도 CI에서 잡힘」 두 단계.

한 줄 요약

pre-commit은 git 커밋 전 자동 검사.

.pre-commit-config.yaml로 도구 등록, 잘못된 코드는 커밋 거부 + 자동 수정.

CI와 함께 두 단계 방어.

더 알아볼 것

- pre-commit 추천 hook 모음

- pre-commit ci — PR 자동 실행

- --no-verify로 우회(주의)