.gitignore 테스터

사용 방법

1. 1

   .gitignore 규칙 붙여 넣기

   주석과 빈 줄까지 포함해 파일 텍스트를 그대로 복사합니다. 결과의 줄 번호는 붙여 넣은 첫 줄부터 세므로 원래 순서를 유지하세요.

2. 2

   테스트할 경로 나열

   저장소 루트 기준 상대 경로를 한 줄에 하나씩, 슬래시로 구분해 입력합니다(역슬래시는 변환됩니다). 무시될 것으로 예상하는 경로와 src/app.ts처럼 유지될 것으로 예상하는 경로를 함께 넣으세요.

3. 3

   검사 실행

   입력하는 즉시 결과가 바뀝니다. 검사한 전체 경로 수, 무시된 경로 수, 무시되지 않은 경로 수를 보여 주고 현재 표시하는 경로를 상태와 결정한 규칙 줄과 함께 나열합니다. 목록과 트리는 현재 필터에서 각각 처음 500개 경로까지만 표시하지만 카운터는 전체 경로를 셉니다. 보기를 바꾸거나 무시된 경로·유지된 경로 필터로 결과를 좁힐 수 있습니다.

4. 4

   규칙 열 읽기

   무시된 경로에는 매치된 패턴의 줄 번호와 내용이 나옵니다. 유지된 경로는 매치된 규칙이 없으면 규칙이 표시되지 않고, ! 규칙이 다시 포함했다면 그 규칙의 줄이 표시됩니다. 규칙 패널은 규칙마다 결정한 경로 수를 세며, 0인 규칙은 어떤 결과도 결정하지 않으므로 오타이거나 다른 규칙에 가려졌거나 중복일 수 있습니다.

5. 5

   고치고 다시 실행

   의외였던 규칙을 고칩니다. 끝 슬래시를 붙이거나 부정 규칙을 덮어쓸 규칙 아래로 옮긴 뒤 모든 경로가 원하는 상태가 될 때까지 다시 실행하세요.

작동 원리

logs/
!logs/keep.log      # 효과 없음: logs/ 디렉터리 자체가 제외됨

logs/*
!logs/keep.log      # 동작함: 항목만 제외됨

실제 예시

규칙:
node_modules/
*.log
!important.log

경로:
src/app.ts
logs/app.log
important.log
node_modules/react/index.js

src/app.ts                   유지
logs/app.log                 무시됨   규칙 2번 줄
important.log                유지      3번 줄이 다시 포함
node_modules/react/index.js  무시됨   규칙 1번 줄

규칙 A:
logs/
!logs/keep.log

규칙 B:
logs/*
!logs/keep.log

경로:
logs/keep.log
logs/other.log

규칙 A:  logs/keep.log 무시됨 (1번 줄), logs/other.log 무시됨 (1번 줄)
규칙 B:  logs/keep.log 유지, logs/other.log 무시됨 (1번 줄)

규칙:
/build
dist/

경로:
build/a.js
src/build/a.js
packages/x/dist/a.js
dist

build/a.js              무시됨  규칙 1번 줄
src/build/a.js          유지
packages/x/dist/a.js    무시됨  규칙 2번 줄
dist                    유지

규칙:
*.env
.env*
!.env.example

경로:
.env
.env.local
.env.example
config/prod.env

.env              무시됨  1번 줄
.env.local        무시됨  2번 줄
.env.example      유지
config/prod.env   무시됨  1번 줄

규칙:
*.log

경로:
../secret.txt
/abs/a.log
./a.log
ok.log

무시됨 1개 (ok.log, 1번 줄), 잘못된 경로 3개 (목록의 1, 2, 3번째 줄)

자주 하는 실수

• 부정 규칙을 규칙보다 앞에 둠

  마지막에 매치된 규칙이 이기므로 순서가 중요합니다. *.log 위에 둔 !keep.log는 아무 일도 하지 않습니다. 아래로 옮기세요.

• 디렉터리를 제외해 놓고 그 안의 파일을 다시 포함하려 함

  Git은 제외된 디렉터리 안을 들여다보지 않습니다. 위 예시처럼 ! 규칙 앞에서는 dir/ 대신 dir/*를 쓰세요.

• 끝 슬래시는 디렉터리 전용이라는 점을 잊음

  build/는 build라는 이름의 디렉터리를 무시하며 build라는 파일은 무시하지 않습니다. 이름만 쓰지 말고 이 도구가 처리하는 build/x.js처럼 디렉터리 안의 경로로 테스트하세요.

• .gitignore가 추적을 해제해 준다고 기대

  규칙은 Git이 이미 추적 중인 파일에는 영향을 주지 않습니다. 그런 파일에는 git rm --cached를 한 번 실행해야 규칙이 적용됩니다.

• 대소문자 구분이 리눅스의 Git과 다름

  여기서는 리눅스의 Git처럼 대소문자를 구분해서 매치하므로 규칙 Build/는 Build/x.js는 무시하지만 build/x.js는 무시하지 않습니다. Windows와 macOS의 Git은 보통 core.ignorecase=true로 동작해 둘 다 무시합니다. "대소문자 무시 (core.ignorecase)" 스위치를 켜면 그 동작을 볼 수 있으니, 팀이 쓰는 시스템의 대소문자 규칙으로 테스트하세요.

• 규칙에 역슬래시 사용

  윈도우식 역슬래시가 있는 경로는 슬래시로 변환되지만 규칙은 변환되지 않습니다. 규칙의 역슬래시는 이스케이프 문자이므로 dist\bundle은 dist/bundle.js에 매치되지 않습니다.

자주 묻는 질문