[Git] .gitignore 사용법 : 깃허브에 올리면 안 되는 파일 숨기기

Github에 프로젝트를 올리다 보면 절대 올라가서는 안 되는 파일들이 있습니다.

• 나만의 비밀번호나 API Key가 적힌 보안 파일
• 용량만 차지하는 빌드 파일 (build, dist 등)
• 라이브러리 모음 폴더 (node_modules 등)
• OS가 자동으로 만드는 시스템 파일 (.DS_Store)

이런 파일들을 Git이 "못 본 척" 무시하게 만드는 설정 파일이 바로 .gitignore 입니다. 오늘은 이 파일을 제대로 사용하는 방법을 알아보겠습니다.

---

1. .gitignore 파일 만들기

사용법은 아주 간단합니다. 프로젝트의 최상위 루트 폴더(보통 .git 폴더가 있는 곳)에 이름이 .gitignore인 파일을 하나 생성하면 됩니다.

주의: 파일 이름 앞에 점(.)이 꼭 있어야 하며, 확장자(.txt 등)가 없어야 합니다.

 

---

2. 작성 문법 (Rule)

메모장이나 코드 에디터(VS Code)로 .gitignore 파일을 열고, 무시하고 싶은 파일이나 폴더 이름을 적으면 됩니다.

1) 특정 파일 무시하기

secret.txt
config.js

해당 이름을 가진 파일은 Git이 추적하지 않습니다.

2) 특정 확장자 전체 무시하기

*.log
*.exe

* (와일드카드)를 사용하면 확장자가 .log나 .exe인 모든 파일을 무시합니다.

3) 특정 폴더 전체 무시하기

node_modules/
build/
.idea/

뒤에 슬래시(/)를 붙이면 해당 폴더와 그 안의 내용물 전체를 무시합니다.

4) 주석 작성하기

# 이것은 주석입니다 (Git이 무시하는 설명글)

샵(#)으로 시작하는 줄은 설정에 영향을 주지 않는 설명글이 됩니다.

---

3. 언어별 필수 설정 (꿀팁 사이트 추천)

*"내 프로젝트(Java, Python, Node.js 등)에서는 뭘 무시해야 하지?"* 일일이 찾기 힘들 때는 gitignore.io 사이트를 추천합니다.

• 사이트: https://www.toptal.com/developers/gitignore

검색창에 내가 사용하는 운영체제(Windows, macOS), 언어(Java, Python), 에디터(IntelliJ, VSCode)를 입력하면 자동으로 완벽한 코드를 만들어줍니다. 그걸 복사해서 붙여넣기만 하면 끝입니다!

---

4. 자주 묻는 질문 (Troubleshooting)

Q. .gitignore에 적었는데도 자꾸 파일이 Github에 올라가요!

A. 이미 Git이 추적하고 있던 파일이라서 그렇습니다.
.gitignore는 Git이 추적하기 전(Untracked) 상태인 파일에만 적용됩니다. 이미 git add나 commit을 한 번이라도 했다면, 캐시를 지워줘야 적용됩니다.

터미널에서 아래 명령어를 순서대로 입력해 주세요.

# 1. 현재 Git의 캐시(기록)를 전부 삭제 (실제 파일은 삭제되지 않음)
git rm -r --cached .

# 2. 다시 모든 파일을 스테이징 (이제 .gitignore가 적용됨)
git add .

# 3. 커밋 하기
git commit -m "Apply .gitignore"

이렇게 하면 기존에 잘못 올라갔던 파일들이 Git 추적 리스트에서 사라지고, .gitignore가 정상 작동하게 됩니다.

---

5. 요약

1. 프로젝트 최상위 폴더에 .gitignore 파일을 만든다.
2. 무시할 파일명, 폴더명(folder/), 확장자(*.log)를 한 줄씩 적는다.
3. 이미 올라간 파일을 제외하려면 git rm -r --cached . 명령어를 쓴다.

---

처음부터 .gitignore를 잘 설정해두면, 나중에 실수로 개인정보가 유출되거나 레포지토리가 지저분해지는 일을 막을 수 있습니다.