Tệp .gitignore là gì và bạn dùng nó như thế nào?

Question

Accepted Answer

Một tệp **.gitignore** cho Git biết những tệp và thư mục nào cần **bỏ qua** — không theo dõi trong quản lý phiên bản. Nó được dùng để loại trừ các tệp sinh ra, dependency, secret, và các tệp đặc thù môi trường vốn không nên được commit.

## .gitignore làm gì

```text
# .gitignore — các mẫu tệp mà Git KHÔNG nên theo dõi
node_modules/          # dependency (được cài lại từ các tệp package, đừng commit)
dist/                  # output build (được sinh ra, đừng commit)
*.log                  # tệp log
.env                   # ⚠️ SECRET / biến môi trường — KHÔNG BAO GIỜ commit!
.DS_Store              # rác đặc thù hệ điều hành
.vscode/               # cấu hình editor (thường mang tính cá nhân)
build/
coverage/
*.tmp
```

Git bỏ qua các tệp khớp với các mẫu này — chúng sẽ không xuất hiện trong `git status`, sẽ không được stage, và sẽ không được commit.

## Cú pháp mẫu

```text
node_modules/    → bỏ qua một thư mục (và mọi thứ trong nó)
*.log            → bỏ qua tất cả tệp có đuôi .log
!important.log   → NGOẠI LỆ: KHÔNG bỏ qua tệp này (phủ định)
/build           → bỏ qua "build" chỉ ở root (dấu gạch chéo đầu = tương đối với root)
doc/*.txt        → các tệp .txt trong doc/ nhưng không trong các thư mục con
**/temp          → "temp" ở bất kỳ đâu trong cây thư mục
```

## Những gì nên bỏ qua (các nhóm phổ biến)

```text
✓ DEPENDENCY — node_modules/, vendor/ (cài lại từ manifest; rất lớn, đừng commit)
✓ OUTPUT BUILD — dist/, build/, *.o (được sinh ra từ mã nguồn)
✓ SECRET — .env, credential, key (⚠️ KHÔNG BAO GIỜ commit secret — một vấn đề bảo mật nghiêm trọng)
✓ tệp MÔI TRƯỜNG/HỆ ĐIỀU HÀNH/EDITOR — .DS_Store, .idea/, .vscode/ (đặc thù cá nhân/máy)
✓ LOG, cache, tệp tạm
```

```text
⚠️ Các tệp đã được theo dõi sẽ không bị bỏ qua khi thêm chúng vào sau — bỏ theo dõi trước:
   git rm --cached <file>   (rồi commit; .gitignore ngăn việc thêm lại)
```

## Tại sao điều này quan trọng

Hiểu `.gitignore` là quan trọng để **giữ repository sạch và an toàn**, nên đó là kiến thức Git thực hành thiết yếu.

Một tệp `.gitignore` loại trừ các tệp **không nên có trong quản lý phiên bản**, giải quyết một số nhu cầu thực tế.

Nó giữ repository sạch bằng cách loại trừ **các tệp sinh ra/phái sinh** (output build, sản phẩm biên dịch) và **dependency** (`node_modules`, vốn rất lớn và được cài lại từ các tệp manifest — commit chúng sẽ làm phình repo) — để repository chỉ chứa mã nguồn có ý nghĩa.

Nó loại trừ **các tệp đặc thù môi trường và cá nhân** (rác hệ điều hành như `.DS_Store`, cấu hình editor) vốn sẽ làm lộn xộn repo và gây nhiễu.

Quan trọng nhất, nó thiết yếu cho **bảo mật**: loại trừ **secret** (tệp `.env`, credential, API key) là điều sống còn vì **commit secret là một sai lầm bảo mật nghiêm trọng** — một khi đã commit, secret nằm trong lịch sử của repository (và có thể được push lên remote/repo công khai nơi chúng có thể bị khai thác), nên `.gitignore` là một phòng tuyến then chốt chống lại việc vô tình commit dữ liệu nhạy cảm.

Hiểu **cú pháp mẫu** (thư mục, ký tự đại diện, phủ định, tương đối với root) cho phép bạn viết các quy tắc ignore hiệu quả, và biết điều "bẫy" quan trọng rằng **các tệp đã được theo dõi phải được bỏ theo dõi** (`git rm --cached`) trước khi `.gitignore` có hiệu lực ngăn được một sự lúng túng phổ biến.

Vì repository sạch (không có tệp sinh ra, dependency hay rác) và đặc biệt là **không commit secret** quan trọng cho chất lượng và bảo mật của repository, và vì `.gitignore` là cơ chế chuẩn để loại trừ các tệp không nên được theo dõi, hiểu `.gitignore` — những gì cần bỏ qua (dependency, output build, và quan trọng là secret), cú pháp mẫu, và cái bẫy bỏ theo dõi — là kiến thức Git thiết yếu, được áp dụng thường xuyên để duy trì các repository sạch, an toàn, với khía cạnh bảo mật giữ secret ra khỏi quản lý phiên bản đặc biệt quan trọng.