SDL中文论坛

标题: .gitignore详解 [打印本页]

作者: ancientcc 时间: 2016-5-17 20:28
标题: .gitignore详解
本帖最后由 ancientcc 于 2016-6-22 12:29 编辑

创建.gitignore
首先要强调一点，这个文件的完整文件名就是“.gitignore”，注意最前面有个“.”。这样没有扩展名的文件在Windows下不太好创建，这里给出win7的创建方法：

创建一个文件，文件名为：“.gitignore.”，注意前后都有一个点。保存之后系统会自动重命名为“.gitignore”。

复制代码

.gitignore书写规则
.gitignore对要管理的目录、文件名不区分大小写。它的基本作用是告诉Git哪些文件不需要添加到版本管理中，比如Python的.pyc文件和一些包含密码的配置文件等等。.gitignore内容是一些规则，Git会根据这些规则来判断是否将文件添加到版本控制中。下面我们看看常用的规则：

/mtk/	过滤整个文件夹
*.zip	过滤所有.zip文件
/mtk/do.c	过滤某个具体文件

很简单吧，被过滤掉的文件就不会出现在你的GitHub库中了，当然本地库中还有，只是push的时候不会上传。

需要注意的是，gitignore还可以指定要将哪些文件添加到版本管理中：

!*.zip	添加所有.zip文件
!/mtk/one.txt	添加/mtk/one.txt文件
![ABC](http://www.libsdl.cn/download/sdl_location.png)	添加图片，ABC是描述性文字

唯一的区别就是规则开头多了一个感叹号，Git会将满足这类规则的文件添加到版本管理中。

为什么要有两种规则呢？想象一个场景：我们只需要管理/mtk/目录中的one.txt文件，这个目录中的其他文件都不需要管理。那么我们就需要使用：

/mtk/
!/mtk/one.txt

复制代码

假设我们只有过滤规则没有添加规则，那么我们就需要把/mtk/目录下除了one.txt以外的所有文件都写出来！

最后需要强调的一点是，如果你不慎在创建.gitignore文件之前就push了项目，那么即使你在.gitignore文件中写入新的过滤规则，这些规则也不会起作用，Git仍然会对所有文件进行版本管理。

简单来说，出现这种问题的原因就是Git已经开始管理这些文件了，所以你无法再通过过滤规则过滤它们。

所以大家一定要养成在项目开始就创建.gitignore文件的习惯，否则一旦push，处理起来会非常麻烦。

多个.gitignore
一个.gitignore只影响它所在目录以及子目录，当一项目有多个目录时，就可以让存在多个.gitignore。

有时多个.gitignore是必须的。举个例子，Visual Studio会把编译结果放在debug目录，上传github时往往就要忽略该目录。但有的源码会把debug作为目录名，像boost库中的<boost>/boost/preprocessor/debug，这个目录就不能忽略了，为此就须要多个.gitignore。

示例：Android Studio 2.0创建的.gitignore
根下的.gitignore

*.iml：忽略所有扩展名是iml的文件。
.gradle：忽略所有名称是.gradle的文件和目录。
/local.properties：忽略和该.gitignore同级的、名称是local.properties的目录和文件。
/.idea/workspace.xml：忽略和该.gitignore同级的.idea/workspace.xml文件。
/.idea/libraries：忽略和该.gitignore同级的.idea/libraries目录。
.DS_Store：忽略所有名称是.DS_Store的文件和目录。
/build：忽略和该.gitignore同级的build目录。注：app目录也会有build，具体怎么处理看后面的“app下的.gitignore”

复制代码

app下的.gitignore

/build：忽略和该.gitignore同级的build目录。
/libs：忽略和该.gitignore同级的libs目录。
/obj：忽略和该.gitignore同级的obj目录。

复制代码

注：libs、obj是我添加的，它们分别的NDK生成的目标文件和库文件。

欢迎光临 SDL中文论坛 (http://www.libsdl.cn/bbs/)