바이브 코딩 →

.gitignore(깃이그노어).gitignore

.gitignore(깃이그노어)는 이삿짐에서 빼놓을 물건 목록 같은 것 — Git이 기록하거나 GitHub에 올리지 않을 파일과 폴더를 적어 두는 설정 파일이에요.

이사할 때 이 상자는 옮기지 말라고 붙여 두면 이삿짐센터가 그 물건은 두고 가죠. .gitignore가 그 쪽지예요. 프로젝트 폴더 맨 위에 .gitignore 파일을 만들고 파일 이름이나 폴더 이름을 한 줄씩 적어 두면, Git은 그 파일들을 변경 기록에 넣지 않고 GitHub에도 올리지 않아요. 비밀값이 든 파일, 너무 큰 파일, 프로그램이 자동으로 만드는 임시 폴더 등을 적어요.

강의에서는 작업 공간을 처음 세팅하며 .gitignore를 다뤄요. API 키가 들어 있는 .env 파일과 용량이 큰 영상 파일은 깃허브에 올리지 않도록 .gitignore에 넣고, 대신 .env.example 파일을 만들어 어떤 값이 필요한지만 공유하는 방식을 알려 줘요. .gitignore에 .env를 넣어야 하는 이유는 .env에 API 키·토큰 같은 비밀값이 들어 있어서예요. 이게 GitHub에 올라가면 다른 사람이 내 계정으로 비용을 쓰거나 서비스를 조작할 수 있어요.

초보가 자주 하는 실수는 이미 올린 파일을 나중에 .gitignore에 추가하면 지워질 거라고 생각하는 거예요. .gitignore는 앞으로 추적하지 않게 할 뿐이라, 이미 커밋한 파일은 기록에 남아 있어요. 비밀값을 실수로 올렸다면 파일을 지우는 것만으로는 부족하고 그 키를 서비스에서 즉시 폐기하고 새로 발급받아야 해요. 그래서 프로젝트를 시작하자마자 .gitignore부터 만드는 습관이 중요해요.

💡 대표 예시

  • 작업 공간 세팅 — .env와 대용량 영상 폴더를 .gitignore에 적는다
  • 값 안내 — .env.example에 필요한 키 이름만 적어 함께 올린다
  • 실수 대응 — 키를 올렸다면 파일 삭제와 함께 키를 즉시 재발급한다
  • 정리 — 자동 생성되는 node_modules 폴더를 업로드 대상에서 뺀다
  • 점검 요청 — 커밋 전 비밀값 파일이 빠졌는지 에이전트에게 확인시킨다

🔗 관련 용어

이 개념, 직접 적용해볼까요?

AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.