.gitignore 패턴

.gitignore는 Git이 추적하지 않을 파일을 적는 목록이다. 파일명 하나를 적을 수도 있고, 확장자·폴더·경로를 패턴으로 지정할 수도 있다. 이 부록은 수업에서 자주 쓰는 문법과 예외 처리만 정리한다.

학습 목표

주석·빈 줄·파일명·확장자·폴더 패턴을 구분한다.
*·?·[abc]·**의 범위를 설명한다.
앞 /와 !의 의미를 알고 예외를 적용한다.
이미 추적 중인 파일을 git rm --cached로 제외한다.
git check-ignore -v로 적용된 패턴을 확인한다.

왜 필요한가

비밀 키, 로그, 운영체제가 만든 파일을 실수로 커밋하면 저장소에 남는다. .gitignore에 패턴을 적어 두면 git status와 git add에서 이런 파일이 보이지 않는다. 패턴의 범위를 정확히 알면 필요한 파일까지 무시하는 실수를 줄일 수 있다.

빈 폴더 유지

Git은 빈 폴더 자체를 추적하지 않는다. 폴더를 저장소에 남기려면 안에 파일을 하나 두는데, .gitkeep을 쓰는 관례가 있다. .gitkeep은 Git이 특별히 인식하는 파일이 아니라 이름을 붙인 관례 중 하나이며, 유일한 표준도 아니다. README.md나 .gitignore를 두어도 폴더가 유지되지만, .gitignore는 패턴에 따라 함께 둔 파일까지 무시할 수 있으므로 내용을 확인한다.

핵심 개념

#으로 시작하는 줄은 주석이다. 빈 줄은 무시된다.
.env는 이름이 정확히 .env인 파일만 무시한다. .env.local처럼 뒤에 이름이 붙은 파일까지 막으려면 .env*를 쓰고, .env.example처럼 공유할 파일은 !.env.example로 다시 포함한다.
node_modules/처럼 폴더를 통째로 무시하면 그 안의 파일은 모두 제외된다.
*.log는 이름이 .log로 끝나는 모든 파일을 뜻한다.
build/처럼 끝에 /를 붙이면 폴더와 그 안의 파일을 함께 무시한다.
/todo.txt처럼 앞에 /를 붙이면 저장소 루트의 todo.txt만 대상으로 한다. 하위 폴더의 todo.txt는 무시하지 않는다.
*는 슬래시를 제외한 글자 여러 개, ?는 글자 하나, [abc]는 괄호 안 글자 하나를 뜻한다.
**는 하위 폴더를 포함한다. docs/**/draft.md는 docs 아래 어느 폴더의 draft.md든 무시한다.
!로 시작하는 줄은 앞에서 무시한 파일을 다시 포함한다. 예를 들어 *.log 뒤에 !keep.log를 두면 keep.log는 추적 대상이 된다. 예외는 무시 규칙 뒤에 와야 효력이 있다.
상위 폴더가 무시되면 그 안의 파일을 !로 다시 포함할 수 없다. 이때는 상위 폴더를 먼저 무시하지 않도록 패턴을 나눈다.
.gitignore는 아직 추적하지 않은 파일에만 적용된다. 이미 git add나 커밋으로 추적 중인 파일은 .gitignore에 적어도 계속 추적된다.
이미 추적 중인 파일은 인덱스에서만 제거하는 git rm --cached <파일명>으로 뺀다. 작업 파일은 그대로 남는다. 파일 자체를 지워도 될 때는 git rm <파일명>을 쓴다.
git check-ignore -v <경로>는 어떤 패턴이 적용됐는지 파일과 줄 번호까지 보여 준다.

예시 표

패턴	뜻	매칭 예
`*.log`	이름이 `.log`로 끝나는 모든 파일	`app.log`, `logs/error.log`
`.env`	이름이 정확히 `.env`인 파일	`.env`
`.env*`	`.env`로 시작하는 모든 파일	`.env`, `.env.local`
`node_modules/`	`node_modules` 폴더와 그 안의 파일	`node_modules/react/index.js`
`build/`	`build` 폴더와 그 안의 파일	`build/index.html`
`/todo.txt`	저장소 루트의 `todo.txt`만	`todo.txt`
`docs/**/draft.md`	`docs` 아래 모든 폴더의 `draft.md`	`docs/a/draft.md`
`log?.txt`	`?` 자리에 글자 하나	`log1.txt`, `logA.txt`
`log[ab].txt`	`[ab]` 중 한 글자	`loga.txt`, `logb.txt`
`!.env.example`	앞에서 무시한 `.env.example`을 다시 포함	`.env*` 뒤에 둘 때
`secrets/`	`secrets` 폴더와 그 안의 파일	`secrets/key.txt`

확인 방법

text

# 무시 여부와 적용된 패턴 확인
git check-ignore -v app.log

# 이미 추적 중인 파일을 인덱스에서 제거
git rm --cached .env
git commit -m "chore: 추적하지 않을 환경 파일 제거"

git check-ignore -v가 아무것도 출력하지 않으면 그 경로는 무시되지 않는다.
git rm --cached는 인덱스에서만 제거한다. 작업 폴더의 파일은 지우지 않는다.
폴더를 통째로 제거하려면 git rm -r --cached <폴더>를 쓴다.

git check-ignore -v .env는 .env를 무시하는 규칙의 위치와 패턴을 .gitignore:1:.env처럼 보여 준다.

`$ git check-ignore -v .env` 결과가 `.gitignore:1:.env`와 `.env`로 보인다.

체크리스트

주석과 빈 줄이 패턴으로 해석되지 않는지 확인했다.
*.log와 build/의 차이를 설명할 수 있다.
앞 /가 저장소 루트를 기준으로 한다는 점을 안다.
! 예외를 적용했고, 상위 폴더가 무시되지 않는지 확인했다.
이미 추적 중인 파일을 git rm --cached로 제거했다.
git check-ignore -v로 적용된 패턴을 확인했다.

주의할 점

.gitignore는 이미 추적 중인 파일에는 적용되지 않는다. 먼저 git rm --cached로 인덱스에서 제거하거나, 파일을 지워도 될 때는 git rm을 쓴다.
build/처럼 상위 폴더를 무시한 뒤 !build/keep.txt를 적어도 keep.txt는 다시 포함되지 않는다. build/*와 !build/keep.txt처럼 나눈다.
!는 앞에서 무시한 대상을 다시 포함할 때만 쓴다. 순서가 바뀌면 결과도 달라진다.
*.log는 logs/ 폴더의 로그도 무시한다. 폴더만 무시하려면 logs/를 쓴다.
운영체제·편집기·비밀 키 패턴을 프로젝트 성격에 맞게 고른다. 다른 프로젝트의 파일을 그대로 복사하지 않는다.
gitignore.io, 저장소 초기화 도구, AI가 만든 초안은 참고용으로만 쓰고, 프로젝트에 필요한 패턴인지 검토한 뒤 사용한다.
비밀번호와 토큰이 이미 커밋됐다면 .gitignore만으로 해결되지 않는다. 해당 값을 폐기하고 새 값으로 교체(회전)한 뒤 이력 정리 여부를 강사와 상의한다.

복습 퀴즈

폴더와 그 안의 파일을 함께 무시하려면 폴더 이름 뒤에 를 붙인다.
앞에서 무시한 파일을 다시 포함할 때 줄 앞에 붙이는 기호는 이다.
이미 추적 중인 파일을 인덱스에서 제거하는 명령은 이다.

.gitignore 패턴 ​

학습 목표 ​

왜 필요한가 ​

빈 폴더 유지 ​

핵심 개념 ​

예시 표 ​

확인 방법 ​

체크리스트 ​

주의할 점 ​

복습 퀴즈 ​

참고 자료 ​