6강. .gitignore와 추적하면 안 되는 파일

?1. 이번 강의에서 해결할 문제

node_modules, 빌드 결과, .env를 저장소에 넣으면 이력이 커지고 환경별 충돌이나 비밀 유출이 발생합니다. 프로젝트 규칙으로 추적 제외 대상을 선언합니다.

✓2. 학습 목표

✓이 강의를 마치면

• .gitignore 패턴의 기준 경로를 이해합니다.
• 무시 여부와 적용된 규칙을 검사합니다.
• 이미 추적 중인 파일을 작업 폴더에서 지우지 않고 추적 해제합니다.

◇3. 핵심 개념

.gitignore는 아직 추적하지 않는 파일에 적용됩니다. /build/는 저장소 루트의 build 폴더, *.log는 모든 로그 파일을 의미합니다. 공유할 설정 예시는 .env.example로 두고 실제 값이 있는 .env는 제외합니다.

§4. 단계별 명령어와 예시

파일 경로: C:\dev\git-learning-site\.gitignore

PowerShell

Set-Location C:\dev\git-learning-site
@'
node_modules/
build/
.env
*.log
!.gitkeep
'@ | Set-Content -Encoding utf8 .gitignore
git check-ignore -v .env
git status --short
git add .gitignore
git commit -m "chore: ignore local and generated files"

이미 추적된 .env가 있다면 실제 파일은 남기고 index에서만 제거합니다.

PowerShell

git rm --cached .env
git commit -m "security: stop tracking local environment file"

→5. 명령어가 동작하는 이유

ignore 규칙은 Git의 untracked 파일 탐색을 필터링합니다. git check-ignore -v는 어떤 파일의 몇 번째 규칙이 적용됐는지 보여 줍니다. git rm --cached는 index에서만 제거하므로 작업 폴더 파일은 보존합니다.

!6. 자주 하는 실수와 안전한 해결법

!자주 하는 실수

• .gitignore에 추가하면 과거 기록도 사라진다고 생각함: 이미 커밋된 비밀은 남습니다. 21강의 유출 대응을 따릅니다.
• git rm .env 사용: 파일 자체도 지워집니다. 로컬 파일을 유지하려면 --cached를 사용하고 status를 확인합니다.
• .env.example에도 실제 키 입력: 변수 이름과 가짜 값만 기록합니다.

✎7. 직접 실습

✎직접 실습

1. debug.log, .env, build/index.html을 만든 뒤 status에 나타나지 않는지 확인합니다.
2. .env.example은 추적 대상이 되도록 만듭니다.
3. git check-ignore -v debug.log로 적용 규칙을 찾습니다.

?8. 이해 점검 질문 3개

?이해 점검

1. .gitignore가 이미 커밋된 파일에 바로 적용되지 않는 이유는 무엇인가요?
2. 파일은 남기고 Git 추적만 중단하는 명령은 무엇인가요?
3. 어떤 ignore 규칙이 적용됐는지 확인하려면 어떻게 하나요?

■9. 핵심 요약

■핵심 요약

생성 가능하거나 환경마다 다르거나 비밀인 파일은 추적하지 않습니다. ignore 적용 전후로 status와 check-ignore를 확인하고, 이미 추적된 파일은 rm --cached로 조심스럽게 분리합니다.