Git hook คืออะไรและใช้งานอย่างไร?

Question

Accepted Answer

**Git hook** เป็นสคริปต์ที่ Git รัน**โดยอัตโนมัติ**ที่จุดบางจุดใน workflow ของ Git (ก่อน/หลัง commit, push, merge ฯลฯ) มันเปิดทางให้ทำงานอัตโนมัติ — บังคับใช้มาตรฐาน, รันการตรวจสอบ และกระตุ้นการกระทำ — และถูกใช้อย่างแพร่หลายสำหรับคุณภาพโค้ดและการผสานกับ CI

## hook คืออะไร

```text
Hooks are executable scripts in .git/hooks/ (or managed by tools) that Git runs on EVENTS:
  CLIENT-SIDE (local):
    pre-commit   → before a commit is created (lint, format, run quick tests)
    commit-msg   → validate/format the commit message
    pre-push     → before pushing (run tests, prevent pushing broken code)
    post-merge/checkout → after merge/checkout (e.g. reinstall dependencies)
  SERVER-SIDE (on the remote):
    pre-receive / update → enforce policies on push (reject bad pushes)
    post-receive → trigger deployment/CI/notifications after a push
```

## การใช้งานทั่วไป

```text
✓ pre-commit → LINT and FORMAT code; run quick tests; block secrets/debug code
  → catch issues BEFORE they're committed (fast feedback, consistent quality)
✓ commit-msg → enforce message format (e.g. Conventional Commits)
✓ pre-push → run the test suite → don't push failing code
✓ server-side → enforce policies; trigger CI/CD and deployments
```

## การจัดการ hook ในทีม

```text
⚠️ .git/hooks/ is LOCAL and NOT committed → hooks aren't shared automatically.
To share hooks across a team, use tools:
  → HUSKY (JS ecosystem), pre-commit (Python framework), lefthook, etc.
  → these version hooks in the repo and install them for everyone
→ Combined with CI: hooks give FAST LOCAL feedback; CI is the enforced safety net
  (hooks can be bypassed with --no-verify, so CI must also enforce).
```

## ทำไมจึงสำคัญ

การเข้าใจ Git hook เป็นความรู้ระดับ senior ที่มีคุณค่าต่อ**การทำงานอัตโนมัติของการตรวจสอบคุณภาพและการกระทำใน workflow** จึงมีประโยชน์ต่อการรักษาคุณภาพโค้ดและการผสานกับ CI/CD

hook เปิดทางให้**ทำงานอัตโนมัติที่ event สำคัญของ Git** — รันสคริปต์โดยอัตโนมัติก่อน/หลัง commit, push, merge ฯลฯ — ซึ่งถูกใช้อย่างแพร่หลายเพื่อบังคับใช้มาตรฐานและจับปัญหาแต่เนิ่น ๆ

การใช้งานที่พบบ่อยและมีคุณค่าที่สุดคือ **pre-commit hook** สำหรับรัน **linting, formatting, การทดสอบเร็ว และการตรวจหา secret ก่อนที่โค้ดจะถูก commit** — ให้ feedback ที่รวดเร็วและรับประกันคุณภาพที่สอดคล้องโดยอัตโนมัติ (ทำให้ปัญหาถูกจับที่เวลา commit แทนที่จะภายหลังใน CI หรือ review) เป็นแนวปฏิบัติที่ได้รับความนิยมอย่างมาก

การใช้งานอื่น ๆ (commit-msg hook ที่บังคับใช้ข้อตกลงข้อความอย่าง Conventional Commits, pre-push hook ที่รันการทดสอบเพื่อป้องกันการ push โค้ดที่เสีย และ server-side hook ที่บังคับใช้นโยบายหรือกระตุ้น CI/CD และการ deploy) ขยายการทำงานอัตโนมัติไปทั่ว workflow

การเข้าใจแง่มุม**การจัดการในทีม**เชิงปฏิบัติสำคัญ: `.git/hooks/` อยู่ในเครื่องและ**ไม่ถูก commit** ดังนั้น hook จึงไม่ถูกแชร์โดยอัตโนมัติ — การแชร์ข้ามทีมต้องใช้เครื่องมืออย่าง **Husky, pre-commit หรือ lefthook** ที่ version hook ใน repo และติดตั้งให้ทุกคน

ที่สำคัญ การเข้าใจว่า hook **สามารถถูกข้ามได้** (`--no-verify`) หมายความว่ามันให้ feedback ใน*เครื่อง*ที่รวดเร็วแต่ **CI ต้องบังคับใช้ด้วย**ในฐานะตาข่ายนิรภัยที่แท้จริง — เป็นข้อมูลเชิงลึกสำคัญเกี่ยวกับ defense in depth (hook ในเครื่องเพื่อความเร็ว, CI เพื่อการบังคับใช้)

เนื่องจากการทำงานอัตโนมัติของการตรวจสอบคุณภาพและการกระทำใน workflow ช่วยปรับปรุงคุณภาพและความสอดคล้องของโค้ด และเนื่องจาก Git hook (โดยเฉพาะ pre-commit สำหรับการตรวจสอบในเครื่อง จัดการผ่านเครื่องมือและเสริมด้วย CI) เป็นกลไกที่ใช้อย่างแพร่หลายสำหรับสิ่งนี้ การเข้าใจ Git hook — มันคืออะไร, การใช้งานทั่วไป, การจัดการในทีมด้วยเครื่องมือ และความสัมพันธ์กับ CI — จึงเป็นความรู้ระดับ senior ที่มีคุณค่าต่อการสร้าง workflow การพัฒนาที่เป็นอัตโนมัติและมุ่งเน้นคุณภาพ สะท้อนแนวปฏิบัติที่ใช้รักษาคุณภาพในทีมมืออาชีพ