.gitignore로 불필요한 파일 관리하기

GitHub 로고 이미지

 

 

 

 

✅ .gitignore로 불필요한 파일 관리하기

– 꼭 필요한 파일만 추적하고, 나머지는 무시하세요!

---

✨ 들어가며

Git으로 프로젝트를 관리하다 보면
"올리면 안 되는 파일"까지 같이 올라가는 경우가 있어요.
예를 들어…

• 개인 설정 파일 (.vscode/, .DS_Store)
• 빌드 결과물 (dist/, *.class)
• 보안 정보가 담긴 파일 (.env, api_keys.txt) 등등

이런 파일들은 Git에서 추적하지 않도록 차단해줘야 하죠!
그럴 때 사용하는 게 바로 .gitignore 파일이에요.

---

📁 1. .gitignore란?

.gitignore 파일은
Git이 무시해야 할 파일이나 폴더를 지정하는 텍스트 파일이에요.

이 파일에 적힌 내용은 Git이 추적하지 않아요.
즉, git status, git add, commit 시에도 무시됨!

---

📝 2. .gitignore 파일 만들기

📌 방법 1: 직접 만들기

1. 프로젝트 루트 폴더에 .gitignore 파일 생성
2. 아래처럼 무시할 항목을 적어주세요

# 컴파일 결과물
/dist
/build

# 로그 파일
*.log

# 환경 변수 파일
.env

# macOS 시스템 파일
.DS_Store

 

📌 방법 2: GitHub에서 제공하는 템플릿 사용

GitHub 공식 저장소에 언어별 .gitignore 템플릿이 있어요!
👉 https://github.com/github/gitignore

---

🚨 3. 이미 추적 중인 파일은 무시되지 않아요!

중요 포인트!
.gitignore는 "새로 추가되는 파일"에만 적용돼요.
이미 Git에 추가된 파일은 무시하지 않아요.

➤ 기존에 추적 중인 파일을 무시하려면?

git rm --cached 파일명

 

예시:

git rm --cached .env

 

그리고 .gitignore에 .env 추가해주면 끝!

---

🧰 4. 유용한 무시 패턴 예시

# node_modules 전체 무시 (Node.js 프로젝트)
node_modules/

# 특정 확장자 무시
*.log
*.zip

# 폴더 전체 무시
temp/
backup/

# 특정 폴더 아래 특정 파일 무시
docs/*.log

 

---

🧹 5. .gitignore는 버전 관리해도 돼요?

네!
.gitignore 파일은 팀 프로젝트에서도 같이 공유하는 게 좋아요.
서로 어떤 파일을 무시해야 하는지 기준을 맞출 수 있거든요.

---

🏁 마무리하며

.gitignore는 단순하지만 정말 중요한 파일이에요.
처음부터 제대로 설정해두면,
나중에 실수로 중요한 파일을 올리는 일도 막을 수 있고,
프로젝트도 훨씬 깔끔하게 관리할 수 있어요!