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。