1.为什么要忽略添加?
当你使用git add .
的时候有没有遇到把你不想提交的文件也添加到了缓存中去?比如项目的本地配置信息,如果你上传到Git中去其他人pull下来的时候就会和他本地的配置有冲突,所以这样的个性化配置文件我们一般不把它推送到git服务器中,但是又为了偷懒每次添加缓存的时候都想用git add .
而不是手动一个一个文件添加,该怎么办呢?很简单,git为我们提供了一个.gitignore文件只要在这个文件中申明那些文件你不希望添加到git中去,这样当你使用git add .
的时候这些文件就会被自动忽略掉。
2.忽略文件的原则
- 忽略操作系统自动生成的文件,比如缩略图等;
- 忽略编译生成的中间文件、可执行文件等,也就是如果一个文件是通过另一个文件自动生成的,那自动生成的文件就没必要放进版本库,比如Java编译产生的.class文件;
- 忽略你自己的带有敏感信息的配置文件,比如存放口令的配置文件。
3.使用方法
首先,在你的工作区新建一个名称为.gitignore
的文件。
然后,把要忽略的文件名填进去,Git就会自动忽略这些文件。
不需要从头写.gitignore文件,GitHub已经为我们准备了各种配置文件,只需要组合一下就可以使用了。所有配置文件可以直接在线浏览:https://github.com/github/gitignore
4.例子
比如你的项目是java项目,.java
文件编译后会生成.class
文件,这些文件多数情况下是不想被传到仓库中的文件。这时候你可以直接适用github的.gitignore文件模板。https://github.com/github/gitignore/blob/master/Java.gitignore 将这些忽略文件信息复制到你的.gitignore文件中去:
1 | *.class |
可以看到github为我们提供了最流行的.gitignore文件配置。
保存.ignore文件后我们查看下git status,检查下是否还有我们不需要的文件会被添加到git中去:
1 | $ git status |
比如我的项目目录下有一个Config.ini文件,这个是个本地配置文件我不希望上传到git中去,我们可以在gitignore文件中添加这样的配置:
1 | Config.ini |
或者你想忽略所有的.ini文件你可以这样写:
1 | *.ini |
如果有些文件已经被你忽略了,当你使用git add
时是无法添加的,比如我忽略了*.class
,现在我想把HelloWorld.class
添加到git中去:
1 | $ git add HelloWorld.class |
git会提示我们这个文件已经被我们忽略了,需要加上-f
参数才能强制添加到git中去:
1 | $ git status |
这样就能强制添加到缓存中去了。
如果我们意外的将想要忽略的文件添加到缓存中去了,我们可以使用rm
命令将其从中移除:
1 | $ git rm HelloWorld.class --cached |
如果你已经把不想上传的文件上传到了git仓库,那么你必须先从远程仓库删了它,我们可以从远程仓库直接删除然后pull代码到本地仓库这些文件就会本删除,或者从本地删除这些文件并且在.gitignore文件中添加这些你想忽略的文件,然后再push到远程仓库。
5.查看gitignore规则
如果你发下.gitignore
写得有问题,需要找出来到底哪个规则写错了,可以用git check-ignore
命令检查:
1 | $ git check-ignore -v HelloWorld.class |
可以看到HelloWorld.class
匹配到了我们的第一条*.class
的忽略规则所以文件被忽略了。
6.忽略规则文件语法
a.忽略指定文件/目录
1 | # 忽略指定文件 |
b.通配符忽略规则
通配符规则如下:
1 | # 忽略.class的所有文件 |