나무모에 미러 (일반/밝은 화면)
최근 수정 시각 : 2026-04-08 22:15:54

.gitignore


1. 개요2. 문법3. 기타

1. 개요

Git을 통한 버전 관리를 할 때, 저장소 내 항상 untrack할 파일 및 파일 패턴들을 설정하기 위한 목적의 설정 파일.

2. 문법

기본적으로 각 줄에 한 패턴씩 나열한다. 빈 줄은 무시되며, #으로 시작하는 줄은 주석이다. !로 제외 패턴을 사용하는 경우 순서가 영향을 미칠 수 있다.

/로 끝나는 줄은 반드시 폴더만 매칭된다. 가령 .gitignore 파일 내용이
sephiroth
munya/
와 같다면, 이름이 munya인 폴더는 ignore되지만 munya인 파일은 ignore되지 않는다. /로 끝나지 않는다면 기본적으로 둘다 매칭되며, 따라서 위 경우 sephiroth라는 이름의 파일과 폴더 모두 ignore된다.

끝이 아닌 위치에 /를 사용할 경우 상대 경로로 인식되며, 현재 해당 .gitignore 파일이 위치한 경로에서 상대 경로로 평가한다. 물론 저장소 루트 말고 폴더 내에 .gitignore를 넣어도 되며, 이 경우 당연히 안쪽 스코프가 더 우선된다. 참고로 반드시 Unix식 / 문자여야 하며, 윈도우처럼 \를 사용하면 이스케이프 문자로 인식된다.

*를 사용하면 /를 제외한 이후의 모든 경로가 매칭되며, !를 앞에 붙히면 제외 패턴이 되어 해당 패턴에 매칭되는 값을 포함한다. 폴더 자체를 한번 ignore하면 그 안 파일은 나중에 제외 패턴으로도 취소가 불가능하기 때문에, 폴더 내 파일을 화이트리스트하려면 폴더 내 모든 파일을 ignore하고 허용할 파일들만 제외 패턴으로 넣는 트릭을 써야 한다. 가령 wiki 폴더에서 namu 파일/폴더만 버전 관리하려면
wiki/*
!wiki/namu
와 같이 써야 한다. 순서에 주의하자.

3. 기타

디버깅시 check-ignore -v를 사용하면 좋다.