주요 개발 스택별 .gitignore 모범 예시
현대 개발 환경(Node.js, Python, Java, .NET, Unity, Docker 등)에서 널리 활용되는 실용적인 .gitignore 스니펫 모음.
JavaScript 패키지 매니저(npm, pnpm, yarn, bun), TypeScript 컴파일 결과물, Next.js 빌드 캐시 및 로컬 환경 변수 파일을 제외하는 표준 설정입니다:
# Dependencies
node_modules/
.pnp
.pnp.js
# Build outputs & caches
dist/
build/
.next/
out/
# Logs & runtime files
npm-debug.log*
yarn-debug.log*
yarn-error.log*
.turbo
# Environment variables
.env*.local
.env컴파일된 바이트코드(__pycache__), 가상환경 폴더(.venv, venv, poetry), 패키징 배포 폴더 및 테스트 캐시를 제외합니다:
# Bytecode & cache
__pycache__/
*.py[cod]
*$py.class
# Virtual environments
.venv/
venv/
env/
ENV/
# Distribution & packaging
build/
dist/
*.egg-info/
# Pytest & coverage
.pytest_cache/
.coverage
htmlcov/Maven 또는 Gradle 빌드 도구를 사용하는 JVM 프로젝트를 위한 규칙. 컴파일된 .class 파일, JAR 아티팩트 및 로컬 빌드 데몬 캐시를 제외합니다:
# Compiled class files
*.class
# Package files
*.jar
*.war
*.ear
# Maven build directory
target/
pom.xml.tag
pom.xml.releaseBackup
# Gradle build cache
.gradle/
build/Roslyn 컴파일러 출력 폴더, NuGet 패키지 캐시, Visual Studio 사용자 개인 설정 파일 및 배포 폴더를 제외합니다:
# Build results
[Bb]in/
[Oo]bj/
# Visual Studio user files
.vs/
*.user
*.suo
*.userosscache
# Publish outputs
publish/게임 개발에서는 기가바이트 단위에 달하는 대용량 자동 생성 에셋 캐시와 임시 빌드 결과물을 필히 제외해야 합니다:
# Large generated asset cache
/[Ll]ibrary/
/[Tt]emp/
/[Oo]bj/
/[Bb]uild/
/[Bb]uilds/
/[Ll]ogs/
/[Uu]ser[Ss]ettings/
# Memory dumps
sysinfo.txt
*.stackdump컨테이너 환경 설정, 로컬 전용 Compose 오버라이드 파일 및 로컬 보안 키 파일의 유출을 방지하는 규칙입니다:
# Local compose overrides
docker-compose.override.yml
# Environment secrets
.env
*.env.local
# Kubernetes local contexts
kubeconfig
*.kubeconfig자주 묻는 질문 (FAQ)
.gitignore 규칙, 캐싱, 저장소 설정에 대해 개발자들이 가장 자주 묻는 질문과 실전 해결책입니다.
여러 언어를 함께 사용하는 프로젝트의 규칙은 어떻게 병합하나요?
각 스택의 규칙을 이어 붙이되 중복 라인을 제거하여 정리합니다. DotGitIgnore 생성기를 이용하면 문법 충돌 없이 자동으로 최적화할 수 있습니다.
package-lock.json이나 poetry.lock 같은 잠금 파일도 제외해야 하나요?
아닙니다. 잠금 파일은 팀원들과 CI 빌드 환경에서 완전히 동일한 버전의 패키지를 재현하기 위해 필수적이므로 반드시 커밋해야 합니다.
API 키와 비밀 정보는 어떻게 관리하는 것이 가장 좋나요?
저장소에 비밀 키를 커밋하지 마세요. .env 파일을 .gitignore에 추가하고, 가짜 값이 들어간 템플릿인 .env.example만 커밋하세요.
.gitignore 가이드 및 기술 리퍼런스
이미 커밋되어 추적 중인 파일을 제외하는 방법
.gitignore를 추가하기 전에 실수로 커밋해 버린 설정 파일이나 빌드 결과물을 인덱스에서 안전하게 지우는 완벽 가이드.
.gitignore 문법 및 패턴 매칭 가이드
패턴 형식, 와일드카드 글로빙, 선행/후행 슬래시의 역할, ! 부정 규칙 사용 시 주의사항, 문자 범위 지정 등 Git 무시 문법의 모든 것.
Git에서 디렉터리를 올바르게 무시하는 법
폴더 제외 규칙의 핵심: 후행 슬래시 동작 원리, 루트 기준 상대 경로, 서브디렉터리 및 빈 디렉터리 보존 방법.