.gitignore 生成器

组合 13 种语言、7 种框架、macOS/Windows/Linux 以及常用 IDE 的精选模板,生成 .gitignore,并自动去除重复规则。

.gitignore

什么是 gitignore 生成器?

.gitignore 文件告诉 Git 哪些文件不纳入版本控制,例如依赖、构建产物、日志、密钥和编辑器设置。勾选你的项目使用的语言、框架、操作系统和编辑器,工具就会把精选模板合并成一个整洁的 .gitignore,并去除重复的规则。

如何使用 gitignore 生成器

  1. 在 编程语言、框架、操作系统 和 编辑器和 IDE 下勾选需要的模板(用 筛选模板 来查找)。
  2. 在 额外规则(每行一条) 下添加项目特有的行。
  3. 复制结果,或下载为 .gitignore 并放到仓库的根目录。

示例

输入
Node.js + macOS
输出
# ===== Node.js =====
# Dependencies
node_modules/
jspm_packages/
…
# Environment
.env
.env.*
!.env.example

# ===== macOS =====
.DS_Store
.AppleDouble
.LSOverride
._*
.Spotlight-V100
.Trashes

何时使用 gitignore 生成器

适合新建仓库或为项目引入新工具时使用。注意 .gitignore 只影响未被跟踪的文件:如果某个文件已经提交,需要先用 git rm --cached <file> 把它从索引中移除。请提交 .gitignore 本身,让整个团队共用;如果你愿意,也可以把个人的编辑器文件放到全局 gitignore 中。

gitignore 生成器 的工作原理

模板精选自被广泛使用的 github/gitignore 集合,并裁剪到只保留要点。它们按固定顺序拼接(语言 → 框架 → 操作系统 → 编辑器),每个模板都有一个 # ===== 名称 ===== 标题。已经在前面的模板中出现过的规则会被跳过,没有规则的注释标题会被丢弃;你添加的额外规则如果尚不存在,会附加在“Custom”部分之下。

常见用例

  • 启动新的 Node.js、Python 或 Java 仓库
  • 让 .env 文件和密钥不进入 Git
  • 忽略 .DS_Store 和 Thumbs.db 之类的系统杂项文件
  • 合并包含多个技术栈的 monorepo 规则

常见问题

为什么我把文件加入 .gitignore 后它仍被跟踪?

Git 只忽略未被跟踪的文件。运行 git rm --cached <file>(文件夹则加 -r)并提交,之后它就会被忽略。

! 前缀是什么意思?

它会重新包含之前的规则忽略的文件,例如 !.env.example 保留示例环境文件,而 .env.* 忽略其他文件。

应该忽略 .vscode 这样的编辑器文件夹吗?

VS Code 模板会忽略个人状态,但保留共享的设置、任务、启动配置和推荐扩展。

探索更多分类