[Git] .gitignore란? Git에서 무시할 파일을 지정하는 법

📌 본 글은 신세계 I&C 부트캠프에서 배운 내용을 기반으로 정리한 글입니다.

❓ .gitignore란?

.gitignore 파일은 Git이 버전 관리에서 무시해야 할 파일/폴더를 지정하는 설정 파일입니다.
즉, 추적하지 않을 파일 목록을 이곳에 작성하면, Git은 해당 항목들을 저장소에 포함시키지 않아요.

---

🤔 왜 무시해야 할까?

1. 개발 환경 설정은 각자 다르기 때문

• 예를 들어, 같은 IntelliJ를 사용해도
  OS(macOS, Windows, Linux)에 따라 .idea나 .iml 설정 내용이 다를 수 있어요.
• 이런 파일이 Git에 올라가면 불필요한 충돌이 발생할 수 있습니다.

  협업 중 "이상한 설정이 적용되었어요" → 대부분 설정파일이 올라간 경우입니다.

2. 보안 문제

• 비밀번호, API 키, 인증 정보가 담긴 .env나 application.yml 등도
  .gitignore로 무시하지 않으면 실수로 공개될 위험이 있어요.

---

📘 예시: 자주 무시하는 파일들

# IDE 설정 파일
.idea/
*.iml

# OS별 파일
.DS_Store
Thumbs.db

# 빌드/의존성 폴더
/node_modules
/build
/dist
/target

# 환경 변수 파일
.env
application-*.yml

---

🛠️ 실전 작성 방법

1. 프로젝트 루트 디렉토리에 .gitignore 파일 생성
   (숨김 파일이므로 탐색기에서 안 보일 수 있음 – VS Code 또는 Git Bash로 확인)

2. 무시하고 싶은 파일이나 폴더를 한 줄씩 작성
   ex)

   .idea/
   *.log
   .env

3. 이미 Git에 올라간 파일은 .gitignore로 무시되지 않으므로 다음처럼 처리해야 함:

   git rm --cached <파일명>

---

💡 팁: .gitignore 자동 생성 사이트

• https://www.toptal.com/developers/gitignore
  → 언어나 IDE를 선택하면 자동으로 .gitignore를 생성해줘요.

---

📌 .gitignore 요약

항목	설명
.gitignore	Git에서 무시할 파일/디렉토리 지정 파일
.idea, .iml	IntelliJ 설정 파일 – 협업 시 꼭 무시해야 함
.env	환경 변수/보안 정보 파일 – 절대 공개 금지
숨김파일	.gitignore처럼 .으로 시작하면 일반적으로 숨김 처리됨

---

✍️ 이 글은 제가 공부하며 직접 정리한 내용입니다.
필요하신 분들과 자유롭게 공유하셔도 좋지만,
출처는 꼭 함께 남겨주시면 감사하겠습니다 :)

🔗 출처: jiyoungdev.log

---

📄 본 글은 CC BY-NC-ND 4.0 라이선스에 따라 보호됩니다.

저작자 표시 ✧ 비영리 ✧ 변경금지