Git기본 흐름

.gitignore 패턴 기초

빌드 산출물, 로그, 비밀 정보처럼 추적하지 않을 파일을 .gitignore 패턴으로 관리하는 기본 카드를 정리합니다.

마지막 수정 2026년 3월 19일

기본 패턴

text

node_modules/
dist/
*.log
.env
!.env.example

설명

.gitignore는 추적하지 않을 파일과 디렉터리를 패턴으로 선언하는 파일입니다.
대표적으로 빌드 산출물, 캐시, 로그, 개인 설정, 비밀 정보 파일을 여기에 넣습니다.
슬래시(/)와 와일드카드(*, **)의 의미가 달라서, 디렉터리만 무시할지 하위 경로까지 무시할지를 구분해야 합니다.
느낌표(!)는 앞선 패턴을 다시 포함시키는 예외 규칙입니다.
이미 Git이 추적 중인 파일은 .gitignore에 적어도 자동으로 추적이 중단되지 않는다는 점이 중요합니다.

짧은 예제

text

.gitignore

dist/
*.log
.env
!.env.example

이미 추적 중인 .env를 멈추려면:
git rm --cached .env

빠른 정리

패턴	의미
`dist/`	`dist` 디렉터리 무시
`*.log`	모든 log 파일 무시
`.env`	정확히 `.env` 파일 무시
`!.env.example`	예외로 다시 포함
`git rm --cached`	이미 추적 중인 파일을 인덱스에서 제거

주의할 점

.gitignore는 미래의 추적만 막습니다. 이미 커밋된 비밀 파일은 그대로 남으므로, 실수로 올라간 경우에는 히스토리 정리와 비밀값 교체까지 따로 고려해야 합니다.

참고 링크

1 sources

Git: gitignore Documentation