github/gitignore · Angular.gitignore
Angular .gitignore 模板详解
说明 Angular.gitignore 忽略 dist、.angular 缓存、out-tsc、coverage 的原因,以及何时应删除忽略 lockfile(package-lock.json、yarn.lock)的规则。
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.gitignore
# 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*
模板来源: github/gitignore/Angular.gitignore @356fd7b (2026-09-11) · CC0-1.0