.gitignore 文件是什么，你如何使用它？

Question

Accepted Answer

**.gitignore** 文件告诉 Git 哪些文件和目录要**忽略** — 不在版本控制中追踪。它用于排除生成的文件、依赖项、机密信息和不应被提交的特定环境文件。

## .gitignore 的作用

```text
# .gitignore — patterns of files Git should NOT track
node_modules/          # dependencies (reinstalled from package files, don't commit)
dist/                  # build output (generated, don't commit)
*.log                  # log files
.env                   # ⚠️ SECRETS / environment variables — NEVER commit!
.DS_Store              # OS-specific junk
.vscode/               # editor config (often personal)
build/
coverage/
*.tmp
```

Git 忽略匹配这些模式的文件 — 它们不会出现在 `git status` 中，不会被暂存，也不会被提交。

## 模式语法

```text
node_modules/    → ignore a directory (and everything in it)
*.log            → ignore all files with a .log extension
!important.log   → EXCEPTION: do NOT ignore this (negation)
/build           → ignore "build" only in the root (leading slash = root-relative)
doc/*.txt        → .txt files in doc/ but not subdirectories
**/temp          → "temp" anywhere in the tree
```

## 要忽略的内容（常见类别）

```text
✓ DEPENDENCIES — node_modules/, vendor/ (reinstalled from manifests; huge, don't commit)
✓ BUILD OUTPUT — dist/, build/, *.o (generated from source)
✓ SECRETS — .env, credentials, keys (⚠️ NEVER commit secrets — a serious security issue)
✓ ENVIRONMENT/OS/EDITOR files — .DS_Store, .idea/, .vscode/ (personal/machine-specific)
✓ LOGS, caches, temp files
```

```text
⚠️ Already-tracked files aren't ignored by adding them later — untrack first:
   git rm --cached <file>   (then commit; .gitignore prevents re-adding)
```

## 为什么这很重要

理解 `.gitignore` 对于**保持仓库清洁和安全**很重要，这是基本的实用 Git 知识。

`.gitignore` 文件排除**不应该在版本控制中的文件**，满足几个实际需求。

它通过排除**生成的/衍生文件**（构建输出、编译的构件）和**依赖项**（`node_modules`，这些文件很大，从清单文件重新安装 — 提交它们会使仓库膨胀）来保持仓库清洁 — 所以仓库只包含有意义的源代码。

它排除了**特定环境和个人文件**（操作系统垃圾如 `.DS_Store`、编辑器配置）这些会使仓库混乱并造成噪音。

最重要的是，它对于**安全性**至关重要：排除**机密信息**（`.env` 文件、凭证、API 密钥）是必要的，因为**提交机密信息是严重的安全错误** — 一旦提交，机密信息就在仓库历史中（并可能被推送到远程/公开仓库，在那里可能被利用），所以 `.gitignore` 是防止意外提交敏感数据的关键防御。

理解**模式语法**（目录、通配符、否定、相对根目录）可以让你编写有效的忽略规则，了解重要的注意事项——**已追踪的文件必须先被取消追踪**（`git rm --cached`）然后 `.gitignore` 才能生效——可以防止常见的误解。

由于干净的仓库（没有生成的文件、依赖项或混乱）特别是**不提交机密信息**对仓库质量和安全性很重要，而且由于 `.gitignore` 是排除不应被追踪的文件的标准机制，理解 `.gitignore** — 要忽略什么（依赖项、构建输出和关键的机密信息）、模式语法和取消追踪的注意事项 — 是维护清洁、安全仓库所必需的、频繁应用的 Git 知识，其中保护机密信息不进入版本控制的安全方面特别重要。