Git 13회차. Git Ignore와 무시할 파일 관리하기

🚫 Git 13회차. Git Ignore와 무시할 파일 관리하기 - 추적하면 안 되는 파일들

프로젝트를 Git으로 관리할 때는 모든 파일을 올리면 안 돼요! 이번 회차에선 무시해야 할 파일을 지정하는 방법과 .gitignore의 정확한 설정법을 알려드립니다 😊

---

🤔 왜 모든 파일을 Git에 올리면 안 될까?

Git은 기본적으로 프로젝트 내 모든 파일을 추적할 수 있어요. 하지만 실무에서는 절대 Git에 올리면 안 되는 파일들이 존재합니다.

📦 Git으로 추적하면 안 되는 대표 파일

• ✔️ IDE 설정 파일 (예: .vscode/, .idea/)
• ✔️ 빌드 결과물 (예: /dist, /build)
• ✔️ 민감한 정보 (예: .env, api_key.json)
• ✔️ 캐시, 로그 파일 (*.log, .DS_Store)
• ✔️ OS나 시스템이 생성하는 파일 (Thumbs.db 등)

이런 파일들은 매번 바뀌거나, 개인마다 달라서 버전 관리가 불필요하고 위험합니다.

---

📄 .gitignore란?

.gitignore는 Git이 추적하지 않아야 할 파일/폴더를 정의하는 설정 파일입니다. 이 파일에 작성된 항목은 Git이 무시하게 됩니다.

프로젝트 루트 디렉토리에 .gitignore 파일을 만들고, 무시할 파일 패턴을 한 줄씩 적어주면 됩니다.

예시

# 빌드 디렉토리
/dist
/build

# 환경 변수
.env

# IDE 설정
.vscode/
.idea/

# OS 생성 파일
.DS_Store
Thumbs.db

# 로그
*.log

---

반응형

🔧 .gitignore 사용법

1. .gitignore 파일 생성

touch .gitignore

2. 무시할 항목 입력

# Python 예시
__pycache__/
*.pyc

# Node.js 예시
node_modules/
.env

3. 적용 확인

git status

무시된 파일은 Untracked files 목록에 나타나지 않습니다.

---

⚠️ 이미 추적 중인 파일은 무시되지 않아요!

.gitignore를 추가해도 이미 Git이 추적하고 있는 파일은 무시되지 않습니다. 이 경우 아래 명령어로 Git 추적을 해제해야 해요.

git rm --cached 파일명

예시

git rm --cached .env

이후 다시 커밋하면 Git이 해당 파일을 추적하지 않게 됩니다.

---

📚 GitHub에서 언어별 .gitignore 템플릿 활용하기

GitHub에서는 각 언어, 프레임워크에 맞는 .gitignore 템플릿을 제공하고 있어요.

1. 템플릿 사이트

https://github.com/github/gitignore

2. 사용하는 방법

curl https://raw.githubusercontent.com/github/gitignore/main/Node.gitignore -o .gitignore

이렇게 하면 Node.js에 특화된 .gitignore 파일을 바로 생성할 수 있어요!

---

📌 .gitignore 설정 꿀팁

• ✔️ 경로는 상대경로 기준 (예: /build → 루트 폴더의 build 디렉토리)
• ✔️ 특정 파일만 무시하고 싶을 땐 이름.확장자 입력
• ✔️ 예외 처리 시 ! 사용 (예: !keep.txt)

예시: logs 디렉토리는 무시하되 특정 로그 파일은 추적

logs/
!logs/important.log

---

📎 .gitignore 설정 예시 모음

✔️ Node.js 프로젝트

node_modules/
.env
dist/
npm-debug.log

✔️ Python 프로젝트

__pycache__/
*.pyc
.env
*.log

✔️ Java + IntelliJ 프로젝트

*.class
/out/
.idea/
*.iml

---

📌 오늘의 핵심 요약

• ✔️ Git은 기본적으로 모든 파일을 추적하지만, 불필요한 파일은 .gitignore로 제외해야 해요
• ✔️ 이미 추적 중인 파일은 git rm --cached로 제거해야 합니다
• ✔️ GitHub 템플릿을 활용하면 더 빠르게 세팅 가능해요

.gitignore 설정은 깔끔한 Git 이력을 만드는 첫걸음입니다. 이제부터는 꼭 필요한 파일만 버전 관리해보세요 😊

---

📎 다음 회차 예고

14회차. GitHub 협업 실습 - Fork, PR, 리뷰까지 따라 하기

✔️ GitHub에서 Fork → 작업 → Pull Request ✔️ 리뷰 요청과 병합까지 ✔️ 오픈소스에도 기여할 수 있는 실전 협업!

---