.gitignore 生成器
组合 13 种语言、7 种框架、macOS/Windows/Linux 以及常用 IDE 的精选模板,生成 .gitignore,并自动去除重复规则。
什么是 gitignore 生成器?
.gitignore 文件告诉 Git 哪些文件不纳入版本控制,例如依赖、构建产物、日志、密钥和编辑器设置。勾选你的项目使用的语言、框架、操作系统和编辑器,工具就会把精选模板合并成一个整洁的 .gitignore,并去除重复的规则。
如何使用 gitignore 生成器
- 在 编程语言、框架、操作系统 和 编辑器和 IDE 下勾选需要的模板(用 筛选模板 来查找)。
- 在 额外规则(每行一条) 下添加项目特有的行。
- 复制结果,或下载为
.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 模板会忽略个人状态,但保留共享的设置、任务、启动配置和推荐扩展。