# .gitignore

# .gitignore 설정

---

## <span style="white-space: pre-wrap;">1. </span>`<span class="editor-theme-code">.gitignore</span>`란?

- `<span class="editor-theme-code">.gitignore</span>`<span style="white-space: pre-wrap;">는 Git이 </span>****추적하지 않을 파일/폴더****를 명시하는 설정 파일이다.
- 주로 아래와 같은 파일들을 제외할 때 사용한다:
    - OS/IDE 생성 파일 (`<span class="editor-theme-code">.DS_Store</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">Thumbs.db</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">.vscode/</span>`)
    - 로그, 빌드 결과물 (`<span class="editor-theme-code">*.log</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">dist/</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">build/</span>`)
    - 민감 정보 (`<span class="editor-theme-code">.env</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">*.pem</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">secret.txt</span>`)
    - 의존성 디렉토리 (`<span class="editor-theme-code">node_modules/</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">vendor/</span>`)

---

## 2. 작성 위치

- `<span class="editor-theme-code">.gitignore</span>`<span style="white-space: pre-wrap;"> 파일은 </span>****저장소 루트 경로****에 위치한다.
- 하위 폴더에 별도로 둘 수도 있으나, 일반적으로 루트에 하나만 둠.

---

## 3. 패턴 작성법

### 3.1 기본 규칙

<table id="bkmrk-%ED%8C%A8%ED%84%B4%EC%84%A4%EB%AA%85%2A.log.log-%ED%99%95%EC%9E%A5%EC%9E%90-%ED%8C%8C%EC%9D%BC"><colgroup><col></col><col></col></colgroup><tbody><tr><th>패턴

</th><th>설명

</th></tr><tr><td>`<span class="editor-theme-code">*.log</span>`

</td><td>`<span class="editor-theme-code">.log</span>`<span style="white-space: pre-wrap;"> 확장자 파일 전체 무시</span>

</td></tr><tr><td>`<span class="editor-theme-code">build/</span>`

</td><td>`<span class="editor-theme-code">build</span>`<span style="white-space: pre-wrap;"> 디렉토리 무시</span>

</td></tr><tr><td>`<span class="editor-theme-code">/secret.txt</span>`

</td><td><span style="white-space: pre-wrap;">루트 경로의 </span>`<span class="editor-theme-code">secret.txt</span>`만 무시

</td></tr><tr><td>`<span class="editor-theme-code">*.pem</span>`

</td><td>`<span class="editor-theme-code">.pem</span>`<span style="white-space: pre-wrap;"> 인증서 파일 전체 무시</span>

</td></tr><tr><td>`<span class="editor-theme-code">!.gitignore</span>`

</td><td>`<span class="editor-theme-code">.gitignore</span>`<span style="white-space: pre-wrap;"> 파일은 무시하지 않음</span>

</td></tr></tbody></table>

---

### 3.2 주석 사용

```gitignore
# 로그 파일 무시
*.log
```

---

### 3.3 제외 항목 설정

```gitignore
# 모든 .env 파일은 무시
*.env

# 단, .env.example은 추적
!.env.example
```

---

## 4. 자주 사용하는 .gitignore 예시

### 4.1 Node.js

```gitignore
node_modules/
npm-debug.log
.env
dist/
```

### 4.2 Python

```gitignore
__pycache__/
*.py[cod]
.env
*.sqlite3
```

### 4.3 Java (IntelliJ 포함)

```gitignore
*.class
*.jar
*.war
*.log
target/
.idea/
*.iml
```

---

## 5. 이미 추적 중인 파일 무시하기

> `<span class="editor-theme-code">.gitignore</span>`에 추가했지만 이미 추적 중인 파일은 무시되지 않는다.

### 5.1 캐시 삭제 후 반영

```bash
git rm --cached 파일명
```

또는 전체 캐시 삭제:

```bash
git rm -r --cached .
git add .
git commit -m "Update .gitignore rules"
```

---

## 6. .gitignore 생성 도구 추천

- [https://www.toptal.com/developers/gitignore](#bkmrk--10)  
    → 언어/프레임워크/IDE 선택만 하면 자동 생성

---

## ✅ 참고 팁

- `<span class="editor-theme-code">.gitignore</span>`<span style="white-space: pre-wrap;">는 </span>****로컬에서만 적용되는 규칙****<span style="white-space: pre-wrap;">이며, Git이 실제로 </span>****commit할 파일을 결정****하는 기준이다.
- <span style="white-space: pre-wrap;">회사/협업 프로젝트는 공통된 </span>`<span class="editor-theme-code">.gitignore</span>`<span style="white-space: pre-wrap;"> 템플릿을 맞춰야 충돌 예방 가능</span>
- `<span class="editor-theme-code">.git/info/exclude</span>`<span style="white-space: pre-wrap;">를 사용하면 </span>****개인용 ignore 설정****도 가능 (공유 안 됨)

---