Angular .gitignore 템플릿 해설

Angular.gitignore는 Angular CLI 프로젝트의 빌드 결과와 캐시를 막는다. 규칙 대부분이 /로 시작해 워크스페이스 루트에만 적용된다.

주의할 점은 /package-lock.json과 /yarn.lock을 무시한다는 것이다. npm은 lockfile을 소스 관리에 넣을 것을 권장하므로, 애플리케이션이라면 이 두 줄을 지우는 편이 일반적이다.

규칙별 해설

패턴	무엇을, 왜 무시하나
/dist//out-tsc//tmp/	빌드 결과ng build 결과와 TypeScript 컴파일 중간 출력, 임시 폴더다.
/.angular/.angular/	Angular CLI 캐시Angular CLI가 빌드 속도를 위해 쓰는 디스크 캐시다. 루트 고정 규칙과 모든 깊이 규칙을 함께 두어 하위 프로젝트의 캐시도 막는다.
/coverage//e2e/test-output/	테스트 결과Karma·Jest 커버리지와 E2E 테스트 결과다.
/node_modules//package-lock.json/yarn.lock	의존성과 lockfilenode_modules는 당연히 제외 대상이지만, lockfile까지 제외하면 설치할 때마다 의존성 버전이 달라질 수 있다.
/.env/.angular-cli.json/.ng/	환경·설정환경 변수 파일과 옛 Angular CLI 설정 파일·폴더다.
*.tsbuildinfonpm-debug.log*yarn-debug.log*yarn-error.log*	로그·빌드 정보TypeScript 증분 빌드 정보와 패키지 매니저 로그다.

실무에서 주의할 점

• 생성기에서 Angular를 고른 뒤 직접 추가할 규칙에 !/package-lock.json을 넣으면 템플릿 원문을 고치지 않고도 lockfile을 되살릴 수 있다.
• src/environments/environment.ts에는 공개돼도 되는 값만 둔다. 이 파일은 빌드 결과에 포함되어 브라우저로 전달된다.
• 에디터 설정은 VisualStudioCode·JetBrains 템플릿을 함께 쓴다.

원본 템플릿

# Angular specific/dist//out-tsc//tmp//coverage//e2e/test-output//.angular/.angular/# Node modules and dependency files/node_modules//package-lock.json/yarn.lock# Environment files/.env# Angular CLI and build artefacts/.angular-cli.json/.ng/# TypeScript cache*.tsbuildinfo# Logsnpm-debug.log*yarn-debug.log*yarn-error.log*

함께 쓰는 템플릿

다른 템플릿 해설