GLOSSARY

.gitignore

입문바이브 코딩

이 페이지는 바이브 코딩 문맥에서 자주 쓰이는 .gitignore의 뜻과 쓰임을 입문 난이도 기준으로 정리한 AI 용어사전 항목입니다. 정의와 맥락, 관련 용어 5개 순서로 묶었으니, 아래 설명을 먼저 읽고 연결된 개념과 글까지 이어서 보면 이해가 빨라집니다.

.gitignore는 Git이 아직 추적하지 않는 파일 가운데 제외할 경로의 패턴을 적는 설정 파일입니다. 빌드 결과나 임시 파일처럼 커밋에 넣지 않을 대상을 프로젝트 안에서 공유할 때 사용합니다. 이미 추적 중인 파일에는 적용되지 않으며, 제외 규칙을 추가해도 과거 커밋에 저장된 내용이 지워지지는 않습니다.

파일 경로에 적용하는 제외 규칙

Git의 gitignore 문서는 파일마다 한 줄씩 적는 패턴으로 제외 대상을 정한다고 설명합니다. 프로젝트 루트의 .gitignore는 저장소의 공통 규칙을 담는 데 쓰며, 하위 폴더에도 별도 파일을 둘 수 있습니다. 패턴을 평가하는 기준 위치와 우선순위가 있으므로 같은 파일 이름이라도 어느 폴더의 규칙에 해당하는지에 따라 결과가 달라집니다.

패턴에는 파일 이름뿐 아니라 와일드카드와 디렉터리 표시를 사용할 수 있습니다. *.log는 해당 패턴에 맞는 로그 파일 이름을 나타내고, 끝의 /는 디렉터리를 대상으로 한 패턴임을 나타냅니다. 규칙을 읽을 때는 확장자만 맞는지보다 경로의 어느 수준에 적용하는지도 살핍니다. 이름이 같은 소스 파일과 생성 파일을 넓은 패턴으로 함께 제외하면 필요한 작업이 커밋에서 빠질 수 있습니다.

!로 시작하는 패턴은 앞서 제외한 경로를 다시 포함하는 데 사용합니다. 다만 부모 디렉터리 자체가 제외되면 그 안의 파일만 다시 포함하는 데 제약이 있습니다. 같은 문서는 Git이 성능상 제외된 디렉터리의 내용을 열거하지 않는다고 설명합니다. 예외 규칙이 보이는 위치에 있다고 모두 적용되는 것은 아니므로 디렉터리와 파일 규칙을 함께 읽습니다.

추적 상태와 무시 상태의 차이

GitHub의 파일 무시 안내는 이미 추적 중인 파일을 무시하려면 먼저 추적 대상에서 빼야 한다고 설명합니다. .gitignore는 추적하지 않은 파일을 선택할 때 쓰는 규칙입니다. 이미 저장소에 들어간 설정 파일을 목록에 추가해도 이후 수정이 자동으로 숨겨지는 것은 아닙니다. 파일이 추적 중인지와 패턴에 맞는지를 따로 확인하면 이 차이를 알 수 있습니다.

추적 대상에서 빼는 작업은 로컬 파일 삭제와도 구별됩니다. 파일을 작업 폴더에 남기면서 다음 커밋부터 저장하지 않도록 바꾸는 선택이 가능합니다. 그러나 과거 커밋에는 이전 내용이 남습니다. 자격 증명을 실수로 커밋했다면 단순히 무시 규칙을 추가하는 것으로 그 값이 회수되지는 않습니다. 유출된 값의 폐기와 교체, 이력에 남은 자료의 처리는 별도 작업입니다.

반대로 무시된 파일은 Git으로 백업되지 않는 경우가 많습니다. 새 컴퓨터에서 저장소를 복제해도 로컬에만 있던 환경 설정과 자료가 생기지는 않습니다. 재생성 가능한 빌드 산출물과 복구에 필요한 개인 자료를 같은 범주로 두면 백업 범위를 잘못 이해할 수 있습니다. 실제 비밀값은 제외하되 필요한 설정 이름과 준비 절차를 예시 파일이나 문서로 남기는 방식으로 복구 조건을 설명합니다.

공유 규칙과 개인 규칙

Git의 제외 규칙 설명은 팀에 배포할 규칙을 .gitignore에 두고, 저장소 안의 개인적인 제외는 .git/info/exclude 같은 위치에서 관리하도록 구별합니다. 편집기가 만든 임시 파일처럼 여러 저장소에서 공통으로 제외할 개인 설정에는 core.excludesFile도 사용합니다. 규칙이 저장된 위치에 따라 다른 작업자의 환경에도 전달되는지가 달라집니다.

AI 코딩 도구에 적용할 작업 지침을 적는 AGENTS.md와도 역할이 다릅니다. .gitignore는 Git의 파일 선택 규칙이고 작업 지침은 에이전트가 수행할 범위를 설명합니다. Git에서 무시한 파일이 디스크에서 사라지거나 모든 도구의 접근 대상에서 자동 제외되는 것은 아닙니다. 특정 도구가 파일을 읽는지는 그 도구의 권한과 자체 설정으로 결정됩니다.

제외 규칙을 바꾼 뒤에는 커밋 후보에서 필요한 파일이 빠지지 않았는지 확인합니다. 새 소스 파일과 복구용 문서, 비밀이 제거된 설정 예시가 실제로 추적되는지 살피면 규칙의 범위를 검토할 수 있습니다. 변경된 패턴과 함께 어떤 파일을 제외하려는지 기록하면, 나중에 파일이 보이지 않을 때 생성 실패와 Git 제외를 구별하기 쉽습니다.

RELATED TERMS