.gitignore 파일은 무엇이며 어떻게 사용하나요?

Question

Accepted Answer

**.gitignore** 파일은 Git에게 어떤 파일과 디렉터리를 **무시**할지, 즉 버전 관리에서 추적하지 않을지 알려줍니다. 생성된 파일, 의존성, 비밀 정보, 환경별 파일처럼 commit해서는 안 되는 것을 제외하는 데 사용됩니다.

## .gitignore가 하는 일

```text
# .gitignore — Git이 추적하지 말아야 할 파일 패턴
node_modules/          # 의존성(package 파일에서 재설치됨, commit 금지)
dist/                  # 빌드 출력물(생성됨, commit 금지)
*.log                  # 로그 파일
.env                   # ⚠️ 비밀 정보 / 환경 변수 — 절대 commit 금지!
.DS_Store              # OS 관련 잡동사니
.vscode/               # 에디터 설정(종종 개인적)
build/
coverage/
*.tmp
```

Git은 이 패턴에 일치하는 파일을 무시합니다. `git status`에 나타나지 않고, stage되지 않으며, commit되지 않습니다.

## 패턴 문법

```text
node_modules/    → 디렉터리(및 그 안의 모든 것) 무시
*.log            → .log 확장자를 가진 모든 파일 무시
!important.log   → 예외: 이것은 무시하지 않음(부정)
/build           → 루트의 "build"만 무시(선행 슬래시 = 루트 기준)
doc/*.txt        → doc/의 .txt 파일이지만 하위 디렉터리는 아님
**/temp          → 트리 어디에서나 "temp"
```

## 무엇을 무시할 것인가(일반적인 범주)

```text
✓ 의존성 — node_modules/, vendor/(manifest에서 재설치; 거대함, commit 금지)
✓ 빌드 출력물 — dist/, build/, *.o(소스에서 생성됨)
✓ 비밀 정보 — .env, 자격 증명, 키(⚠️ 비밀 정보 절대 commit 금지 — 심각한 보안 문제)
✓ 환경/OS/에디터 파일 — .DS_Store, .idea/, .vscode/(개인/머신별)
✓ 로그, 캐시, 임시 파일
```

```text
⚠️ 이미 추적 중인 파일은 나중에 추가해도 무시되지 않음 — 먼저 추적 해제:
   git rm --cached <file>   (그런 다음 commit; .gitignore가 재추가를 방지)
```

## 왜 중요한가

`.gitignore`를 이해하는 것은 **repository를 깨끗하고 안전하게 유지하는 데** 중요하므로 필수적인 실무 Git 지식입니다.

`.gitignore` 파일은 **버전 관리에 있어서는 안 되는** 파일을 제외하여 여러 실제 필요를 충족합니다.

**생성/파생 파일**(빌드 출력물, 컴파일된 산출물)과 **의존성**(`node_modules`처럼 거대하고 manifest 파일에서 재설치되는 것 — commit하면 repo가 비대해짐)을 제외하여 repository를 깨끗하게 유지합니다. 따라서 repository에는 의미 있는 소스만 포함됩니다.

**환경별 및 개인 파일**(`.DS_Store` 같은 OS 잡동사니, 에디터 설정)을 제외하여 repo를 어지럽히고 잡음을 일으키는 것을 방지합니다.

가장 중요하게는, **보안**에 필수적입니다. **비밀 정보**(`.env` 파일, 자격 증명, API 키)를 제외하는 것이 매우 중요한데, **비밀 정보를 commit하는 것은 심각한 보안 실수**이기 때문입니다. 일단 commit되면 비밀 정보는 repository의 히스토리에 남고(잠재적으로 악용될 수 있는 remote/공개 repo에 push될 수도 있음), 따라서 `.gitignore`는 민감한 데이터를 실수로 commit하는 것을 막는 핵심 방어선입니다.

**패턴 문법**(디렉터리, 와일드카드, 부정, 루트 기준)을 이해하면 효과적인 무시 규칙을 작성할 수 있고, **이미 추적 중인 파일은 `.gitignore`가 적용되기 전에 추적을 해제해야 한다**(`git rm --cached`)는 중요한 함정을 아는 것은 흔한 혼란을 방지합니다.

깨끗한 repository(생성된 파일, 의존성, 잡동사니 없음)와 특히 **비밀 정보를 commit하지 않는 것**이 repository 품질과 보안에 중요하고, `.gitignore`가 추적하지 말아야 할 파일을 제외하는 표준 메커니즘이므로, `.gitignore`를 이해하는 것 — 무엇을 무시할지(의존성, 빌드 출력물, 결정적으로 비밀 정보), 패턴 문법, 추적 해제 함정 — 은 깨끗하고 안전한 repository를 유지하기 위한 필수적이고 자주 적용되는 Git 지식이며, 특히 비밀 정보를 버전 관리에서 배제하는 보안 측면이 특히 중요합니다.