Apakah fail .gitignore dan bagaimana anda menggunakannya?

Question

Accepted Answer

Fail **.gitignore** memberitahu Git fail dan direktori yang perlu **diabaikan** — tidak dijejaki dalam kawalan versi. Ia digunakan untuk mengecualikan fail yang dijana, dependency, rahsia, dan fail khusus persekitaran yang tidak sepatutnya di-commit.

## Apa yang dilakukan oleh .gitignore

```text
# .gitignore — patterns of files Git should NOT track
node_modules/          # dependencies (reinstalled from package files, don't commit)
dist/                  # build output (generated, don't commit)
*.log                  # log files
.env                   # ⚠️ SECRETS / environment variables — NEVER commit!
.DS_Store              # OS-specific junk
.vscode/               # editor config (often personal)
build/
coverage/
*.tmp
```

Git mengabaikan fail yang sepadan dengan corak ini — ia tidak akan muncul dalam `git status`, tidak akan di-stage, dan tidak akan di-commit.

## Sintaks corak

```text
node_modules/    → ignore a directory (and everything in it)
*.log            → ignore all files with a .log extension
!important.log   → EXCEPTION: do NOT ignore this (negation)
/build           → ignore "build" only in the root (leading slash = root-relative)
doc/*.txt        → .txt files in doc/ but not subdirectories
**/temp          → "temp" anywhere in the tree
```

## Apa yang perlu diabaikan (kategori biasa)

```text
✓ DEPENDENCIES — node_modules/, vendor/ (reinstalled from manifests; huge, don't commit)
✓ BUILD OUTPUT — dist/, build/, *.o (generated from source)
✓ SECRETS — .env, credentials, keys (⚠️ NEVER commit secrets — a serious security issue)
✓ ENVIRONMENT/OS/EDITOR files — .DS_Store, .idea/, .vscode/ (personal/machine-specific)
✓ LOGS, caches, temp files
```

```text
⚠️ Already-tracked files aren't ignored by adding them later — untrack first:
   git rm --cached <file>   (then commit; .gitignore prevents re-adding)
```

## Mengapa ia penting

Memahami `.gitignore` adalah penting untuk **memastikan repositori bersih dan selamat**, jadi ia merupakan pengetahuan Git praktikal yang penting.

Fail `.gitignore` mengecualikan fail yang **tidak sepatutnya berada dalam kawalan versi**, menangani beberapa keperluan sebenar.

Ia memastikan repositori bersih dengan mengecualikan **fail yang dijana/diterbitkan** (output build, artifak terkompil) dan **dependency** (`node_modules`, yang sangat besar dan dipasang semula daripada fail manifest — melakukan commit padanya akan membengkakkan repo) — supaya repositori hanya mengandungi sumber yang bermakna.

Ia mengecualikan **fail khusus persekitaran dan peribadi** (sampah OS seperti `.DS_Store`, konfigurasi editor) yang akan mengganggu repo dan menyebabkan kekacauan.

Yang paling kritikal, ia penting untuk **keselamatan**: mengecualikan **rahsia** (fail `.env`, kredensial, kunci API) adalah penting kerana **melakukan commit pada rahsia ialah kesilapan keselamatan yang serius** — sebaik sahaja di-commit, rahsia berada dalam sejarah repositori (dan berpotensi di-push ke repo remote/awam di mana ia boleh dieksploitasi), jadi `.gitignore` ialah pertahanan utama terhadap melakukan commit pada data sensitif secara tidak sengaja.

Memahami **sintaks corak** (direktori, wildcard, negasi, relatif-root) membolehkan anda menulis peraturan pengabaian yang berkesan, dan mengetahui perangkap penting bahawa **fail yang sudah dijejaki mesti dinyahjejak** (`git rm --cached`) sebelum `.gitignore` berkesan mengelakkan kekeliruan yang biasa.

Memandangkan repositori yang bersih (tanpa fail yang dijana, dependency, atau kekacauan) dan terutamanya **tidak melakukan commit pada rahsia** penting untuk kualiti dan keselamatan repositori, dan memandangkan `.gitignore` ialah mekanisme standard untuk mengecualikan fail yang tidak sepatutnya dijejaki, memahami `.gitignore` — apa yang perlu diabaikan (dependency, output build, dan secara kritikalnya rahsia), sintaks corak, dan perangkap penyahjejakan — merupakan pengetahuan Git yang penting dan kerap diaplikasikan untuk mengekalkan repositori yang bersih dan selamat, dengan aspek keselamatan menjaga rahsia daripada kawalan versi menjadi sangat penting.