📂 .gitignore - 깃에 불필요한 파일 제외하기!
"내가 만든 프로젝트, 깃에 올리긴 해야 하는데, 일부 파일은 올리고 싶지 않아!"
맞아요. 깃에 올려서는 안 되는 파일들이 있죠. 예를 들면:
- 비밀번호가 포함된 설정 파일
- 컴파일된 결과물 (빌드 파일)
- 로그 파일 (디버깅 기록)
- 시스템 파일 (운영 체제에서 자동으로 생성하는 파일)
이런 파일들은 프로젝트에 필요하지 않으므로 깃에서 추적하지 않도록 해야 해요. 그래서 .gitignore 파일을 작성하여 깃이 이런 파일들을 무시하도록 할 수 있습니다. 🔒
📝 .gitignore 파일이란?
.gitignore는 바로 "깃에서 무시할 파일 목록"을 정의하는 파일이에요. 이 파일을 통해 어떤 파일이 깃에 올라가지 않아야 하는지 지정할 수 있습니다.
파일 이름 앞에 점(.)이 붙어 있는 이유는 바로 숨김 파일로 설정되기 때문이에요.
🔑 .gitignore 파일이 하는 역할:
- 특정 파일이나 폴더를 깃이 추적하지 않도록 만들어요.
- 빌드 파일이나 비밀번호 파일처럼 안전하게 보관해야 하는 것들을 깃에 올리지 않게 해줘요.
✏️ .gitignore 파일 만들기
/build/: 빌드 폴더를 무시*.log: 모든 로그 파일을 무시node_modules/: Node.js 프로젝트에서 자주 생성되는node_modules폴더를 무시secrets.json: 개인 정보가 포함된 비밀번호 파일을 무시
무시할 항목 추가하기.gitignore 파일을 좋아하는 텍스트 편집기로 연 뒤, 깃에서 무시할 파일이나 폴더를 한 줄씩 작성합니다.예시:
# 빌드 파일 무시
/build/
# 로그 파일 무시
*.log
# node_modules 폴더 무시 (Node.js 프로젝트에서 필수)
node_modules/
# 비밀번호 파일 무시
secrets.json
.gitignore 파일 생성하기프로젝트 폴더에 .gitignore 파일을 만들어 주세요. 프로젝트 디렉토리에서 바로 파일을 만들 수 있습니다.예시:
touch .gitignore
⚠️ 주의! 이미 깃에 추가된 파일은 .gitignore로 무시할 수 없다!
.gitignore는 새로 추가되는 파일에 대해서만 무시할 수 있어요. 이미 깃에 추가된 파일은 .gitignore로 무시할 수 없어요. 이 경우, 깃에서 해당 파일을 제거한 후 .gitignore에 추가해야 해요.
예시: 이미 깃에 추가된 파일을 무시하는 방법
- 그 후
.gitignore파일에secrets.json을 추가해요.
이미 깃에 추가된 파일을 삭제하려면:
git rm --cached secrets.json
🌱 .gitignore 작성 예시
여러분이 Node.js 프로젝트를 진행한다고 가정해볼게요. 그럼 필요한 .gitignore 파일을 어떻게 작성할지 알아볼까요?
# Node.js 프로젝트에서 제외할 파일들
# 1. 빌드 파일 (컴파일된 파일들)
dist/
# 2. 의존성 라이브러리 (node_modules 폴더는 제외)
node_modules/
# 3. 개인 정보가 담긴 파일
*.env
secrets.json
# 4. 로그 파일
*.log
# 5. 운영 체제 관련 파일 (예: macOS에서 생성하는 .DS_Store)
.DS_Store
# 6. npm 패키지 캐시
npm-debug.log
이렇게 작성된 .gitignore는 무엇을 제외하는 걸까요?
- dist/: 빌드된 결과물은 깃에 올라가지 않아요.
- node_modules/:
node_modules폴더는 프로젝트의 외부 의존성으로, 다시 설치할 수 있으니 깃에 올릴 필요가 없어요. - secrets.json: 민감한 정보를 담은 파일은 깃에 올라가지 않아요.
- npm-debug.log: 디버깅 로그도 제외되죠.
- .DS_Store: macOS에서 생성하는 숨김 파일을 무시해요.
🛠 .gitignore를 잘 활용하는 팁
1. 자주 사용하는 템플릿 활용하기
여러 프로젝트에서는 기본적인 .gitignore 템플릿이 필요할 수 있어요. GitHub에는 다양한 템플릿이 준비되어 있어서 쉽게 사용할 수 있어요.
GitHub의 .gitignore 템플릿에서 프로젝트에 맞는 템플릿을 찾아보세요!
2. 실수로 깃에 추가된 파일은 삭제하기
.gitignore 파일을 작성한 후, 실수로 깃에 추가된 파일은 git rm --cached 명령어로 제거한 뒤 다시 커밋해야 해요.
🚀 깃을 더 안전하게, 효율적으로 관리하기
이제 여러분은 .gitignore를 사용하여, 불필요한 파일은 깃에서 제외할 수 있게 되었어요! 🔥
이렇게 하면 프로젝트가 깔끔하게 관리될 뿐만 아니라, 개인 정보나 빌드 파일이 깃에 올라가는 걸 방지할 수 있어요.