GIT 可忽略文件或目录的配置文件.gitignore

[TOC]

## .gitignore文件

### 作用
在git提交代码到远端服务器时，有些文件是不希望被提交到远端服务器的。比如开发工具自己生成的文件，引用的第三包，这些文件会增加远程服务的磁盘空间，还有一些项目的配置文件，每个人的配置文件可能都有差异，自己维护自己的就可以了，不需要推送到远端服务器。`.gitignore文件` 的作用，就是可以设置忽略的文件或目录，让这些文件和目录不会被提交到 `本地的git仓库`，从而达到不能推送到远端服务器的作用

### 基本使用
__所在目录：__`.gitignore文件` 和 `.get文件夹` 在同一个目录

### 1. 主要的配置规则

__基础规则：__

+ 一行代表了一项配置
+ 空文件夹默认被忽略，git 跟踪文件，而不是目录
+ 空行不匹配任何文件

__示例目录结构：__.gitignore 文件与 Net-Study 同目录

```bash
Net-Study\Study1\obj\
Net-Study\Study1\Study1\
Net-Study\Study1\Study1\bin\
Net-Study\Study1\Study1\obj\
# 没有后缀的obj文件
Net-Study\obj
Net-Study\Study1\Study1\obj.txt
Net-Study\Study1\Study1\obj2
Net-Study\Study1\Study1\obj2\obj2.txt
Net-Study\Study1\Study1\obj3.txt
```

#### 1.1 注释
在.gitignore文件中使用 `#` 符号开头，表示这行是注释行，一些配置就可以使用注释来备注了，注意注释不能跟在规则之后，否则规则将失效

#### 1.2 忽略目录和文件

__配置规则：__忽略在规则内的所有目录及文件

```bash
# Net-Study下所有obj目录以及文件是obj的都会被忽略
# 例如：Net-Study\Study1\obj\ 目录 和 Net-Study\Study1\Study1\obj\ 目录 以及 Net-Study\obj 文件
# 注意下面忽略的是没有后缀民的obj文件，目录中的obj.txt文件不会被忽略
obj
```

#### 1.3 忽略目录

__配置规则：__忽略具体的目录

```bash
# bin将被忽略
Study1/Study1/bin
```

#### 1.4 忽略文件

__配置规则：__忽略具体的文件

```bash
# obj.txt将被忽略
Study1/Study1/obj.txt
```

#### 1.5 排除被忽略目录或文件

__配置规则：__大范围内忽略了很多目录或文件，但有些指定目录或文件不想被忽略，可以使用 `!` 符号来标记它不被忽略

```bash
obj
# 除了Study1/Study1/obj/目录的文件夹，其它包含obj的文件夹将被忽略
!Study1/Study1/obj/

obj.txt
# 除了Study1\Study1\obj.txt文件，其它包含obj.txt文件将被忽略
!Study1\Study1\obj
```

#### 1.6 通过通配符忽略

+ 星号 `*` :星号代表可匹配多个字符

``` bash
Study1/Study1/obj*
# 上面的规则将可以匹配到下面的列表，这些列表内容都将被忽略，这就是星号通配符的效果
# Net-Study\Study1\Study1\obj
# Net-Study\Study1\Study1\obj.txt
# Net-Study\Study1\Study1\obj2
# Net-Study\Study1\Study1\obj2\obj2.txt
# Net-Study\Study1\Study1\obj3.txt
```

+ 问号 `?` :问号代表可匹配1个字符

``` bash
Study1/Study1/obj?
# 上面的规则将可以匹配到下面的列表，这些列表内容都将被忽略
# Net-Study\Study1\Study1\obj2
# Net-Study\Study1\Study1\obj2\obj2.txt
```

+ 方括号 `[XXX]`：匹配目录列表中的最后一个字符，其中x表示的是文件和目录列表的最后一个字符串，一般要和星号通配符一起使用

```bash
Study1/Study1/*[j2t]
# 上面的规则将可以匹配到下面的列表，这些列表内容都将被忽略
# 最后是 j 在方括号中
# Net-Study\Study1\Study1\obj
# 最后是 j 在方括号中
# Net-Study\obj
# 最后是 t 在方括号中
# Net-Study\Study1\Study1\obj.txt
# 最后是 2 在方括号中
# Net-Study\Study1\Study1\obj2
# 最后是 t 在方括号中
# Net-Study\Study1\Study1\obj2\obj2.txt
# 最后是 t 在方括号中
# Net-Study\Study1\Study1\obj3.txt
```

#### 1.7 双星号忽略

__配置规则：__两个连续的双星号 `**` 代表的是多级别目录

```bash
Study1/**/Debug
# Study1开始Debug结尾的目录都将被忽略，例如下面的列表
# Study1/Study1/bin/Debug
# Study1/Study1/obj/Debug
# Study1/obj/Debug
# Study1/Study1/Debug
# ……，中间的双星是多级目录
```

### 2. 注意事项
+ 如果被.gitignore设置的规则，忽略的文件或目录，已经在本地仓库被跟踪，那么 .gitignore 中设置的规则，也不会生效，要先将要忽略的文件从仓库中删除，并同步到远端，在去加入删除的文件，这时就可以看到效果，忽略规则生效了
+ .gitignore 文件也可以被上传的到远程仓库，同一个仓库的成员使用同一个.gitignore 文件，否则各自设置忽略规则，会导致文件版本不统一