Git .gitignore 模板生成器

勾选你用到的语言与工具,一键生成干净的 .gitignore。可复制,也可直接下载文件。

什么是 .gitignore

.gitignore 是一个放在仓库根目录的文本文件,列出 Git 应当忽略的文件与目录。它能避免把依赖、构建产物、编辑器临时文件和密钥提交进仓库,保持版本库干净、差异可读。

下面是按技术栈分类的常用忽略模板,勾选你用到的项,一键拼出适合你项目的 .gitignore。

通用基础(推荐默认)

语言与框架

编辑器 / IDE

操作系统

工具与构建

生成的 .gitignore

勾选上方模板后点击「生成」,或直接复制下方内容。

使用与常见坑

  • 已跟踪文件不生效:若文件已被提交,需先 git rm --cached <文件> 取消跟踪(保留本地),再提交 .gitignore。
  • 查看命中规则:git check-ignore -v <文件> 可定位是哪一条规则忽略了它。
  • 忽略文件夹:末尾加 /(如 logs/);根目录限定加前导 /(如 /build)。
  • 强制包含例外:用 ! 否定,例如 !.vscode/settings.json 在忽略 .vscode 后仍保留该文件。

常见问题

.gitignore 不生效怎么办?

多半是文件已被 Git 跟踪。先取消跟踪再忽略:git rm --cached <文件>,然后 git add .gitignore 并提交。也可执行 git check-ignore -v <文件> 查看是哪条规则命中。

.gitignore 能忽略已经被跟踪的文件吗?

不能。.gitignore 只对未跟踪文件生效。已跟踪文件需先用 git rm --cached 停止跟踪(保留本地文件),之后才会被忽略。

怎么忽略整个文件夹?

在规则末尾加斜杠,例如 logs/ 忽略 logs 目录及其内容;node_modules/ 忽略依赖目录。加前导斜杠 /build 只忽略根目录下的 build,不加则匹配任意层级的 build。