本文目录
什么是 .gitignore 文件?
.gitignore 文件用于告诉 Git 哪些文件和目录应排除在版本控制之外。它通过 glob 模式匹配文件路径,防止构建产物、依赖、密钥以及 IDE 配置污染你的代码仓库。
每个项目都需要一个 .gitignore 文件。如果没有它,你的仓库就会被生成的文件、node_modules 目录、.env 密钥以及不应提交的操作系统元数据塞满。.gitignore 生成器能在几秒钟内为你的技术栈生成合适的文件。
.gitignore 生成器的工作原理
该生成器允许你为编程语言、框架、IDE 和操作系统选择模板,然后将它们合并为一个 .gitignore 文件。
- 模板选择——从针对 Node.js、Python、Java、Go、Rust 以及数十种其他语言和框架的精选模板中挑选
- 模式去重——当多个模板包含相同的模式时,生成器会移除重复项,让你的文件保持整洁
- 一键复制——将生成的 .gitignore 复制到剪贴板,或直接下载到你的项目根目录
免费试用 —— 无需注册
生成 .gitignore →何时使用 .gitignore 生成器
每当你启动一个新项目,或为现有项目引入一项新技术时,都应生成 .gitignore 文件。
- 新项目搭建——在首次提交之前生成合适的忽略模式,让仓库从一开始就保持干净
- IDE 和操作系统文件——排除 .idea/、.vscode/、.DS_Store、Thumbs.db 以及其他因开发者而异的编辑器/系统元数据
- 构建产物和依赖——忽略 dist/、build/、node_modules/、__pycache__/ 以及其他不应被跟踪的生成目录
常见问题
我可以拥有多个 .gitignore 文件吗?
可以。Git 支持在仓库的任意目录中放置 .gitignore 文件。子目录中 .gitignore 里的模式只对该目录及其子目录生效。大多数项目使用单个根目录 .gitignore,但 monorepo 有时会为每个包使用单独的文件。
如何忽略 Git 已经跟踪的文件?
向 .gitignore 添加模式只对未跟踪的文件生效。要停止跟踪一个已经提交的文件,请先运行 'git rm --cached filename',然后再添加相应模式。该文件将不再被跟踪,但会保留在磁盘上。
什么是取反模式(negation pattern)?
在模式前加上 ! 前缀,可以重新纳入此前某个模式所排除的文件。例如,'*.log' 会忽略所有日志文件,而 '!important.log' 则会重新纳入这个特定文件。取反模式适合用来为宽泛的规则设置例外。