忽略文件.gitignore
你可能会说
有些文件我不想让 Git 管，比如密钥和依赖包，怎么排除掉？
告诉 Git 哪些本地文件不要加入版本记录的规则清单例如可重新下载的工具文件和本机保存的密钥文件，通常会写进忽略规则。它只对还没被版本记录保存的文件生效；已经保存过的文件不会因此消失，已经泄露的密钥也必须立即更换。
你可以这样告诉 AI Agent
请检查 `.env` 是否已被 Git 跟踪；若已提交，先停止跟踪并加入 `.gitignore`，提交不含真值的 `.env.example`。列出所有暴露凭证并立即轮换，不要把忽略规则当成历史清除或加密。
什么时候用
- 在项目开始时就建立 .gitignore，并用状态列表检查结果.gitignore
node_modules/
.next/
.env
.DS_Store匹配规则且尚未跟踪的文件会被忽略 - 排除 node_modules 等能根据项目配置重新生成的内容$ git statusworking tree cleannode_modules 占用 380MB，未出现在待提交列表中
- 排除真实密钥文件，并提交不含真值的示例配置.env🔒 仅保留在本地密钥保留在本地，不提交到远程仓库
- 参考官方或社区模板后，再按当前项目调整规则Add .gitignoreNode模板库：github.com/github/gitignore
什么时候不用
- 把依赖目录提交到仓库，增加体积并制造无关差异node_modules 380MBgit push →大量可重新安装的依赖进入仓库，应由 .gitignore 排除
- 把 .gitignore 当成加密工具；它只是告诉 Git 不要记录.env 已推送到远程。
① 立即到服务平台轮换或吊销密钥
② 使用 BFG / filter-repo 清理历史删除当前文件不会移除历史提交中的敏感内容 - 文件已经被跟踪后才补规则；还要另外停止跟踪.env 已提交，之后才添加 .gitignore 规则…$ git statusmodified: .env已跟踪文件不受 .gitignore 影响，需要 git rm --cached
- 密钥已经泄露却只删除文件，没有立即更换密钥.gitignore
*忽略全部文件会使新增页面无法进入版本控制
组成结构 · Anatomy
.gitignore
node_modules/ 依赖目录，npm install 随时装回来
.next/ 构建产物，npm run build 会重新生成
.env 密钥文件，见 {c:env-var}，不应提交到仓库
.DS_Store mac 系统生成文件，与项目代码无关
体积较大的第三方包；按 package.json 和锁文件可重新安装
打包生成的结果，每次 build 都会重新产出
可能包含 API 密钥等敏感配置，不应提交到仓库
操作系统自动生成的小文件，与代码无关
常见变体 · Variants
指定文件Exact
.env
只忽略名称完全匹配的文件
整个目录Directory
node_modules/
末尾加斜杠，忽略整个文件夹
通配一类Wildcard
*.log
同后缀的一类文件全部忽略
保留例外Negate
!keep.log
以感叹号开头，使该文件不受前面规则忽略
典型使用场景
新建 .gitignore 文件
git status 前后对比
# 没写 .gitignore 时：
$ git status
Untracked: node_modules/ .next/ .env .DS_Store …（列表很长）
# 写好 .gitignore 后：
$ git status
Changes not staged: modified: index.html
列表仅显示需要处理的项目文件
GitHub 模板库
Create a new repository
Add .gitignore
Node ▾
💡 已有项目想补模板？去 github.com/github/gitignore，搜 Node 复制整份
.env 泄露补救
⚠ .env 已经推送到远端
应立即把其中的密钥视为已经泄露
1
立即到服务平台轮换或吊销该密钥，并创建新的密钥
2
先备份，并按托管平台与团队流程评估是否清理历史。共享仓库需要协调协作者、分支和开放中的 PR；个人不要直接改写历史
BFG 或 git filter-repo 只是可选工具，改写后通常还涉及受控强推；Fork、缓存或旧克隆也可能保留对象。验收时先确认旧密钥已经失效
延伸阅读 · 权威出处
快速练习