.gitignore文件用法及如何配置

.gitignore文件是在git提交的时候用来屏蔽某些你不想提交上去的文件。
项目开发过程中，有时候不想把一些文件（如中间文件/编译文件等）提交到git上。这个时候就由.gitignore文件来筛选出不想提交的文件。所筛选的文件/夹将不会被追踪（tracked），push的时候也不会上传到git上。

创建

我们需要在提交Git之前，需要自己创建一个.gitignore文件，由于Windows下创建文件必须键入文件名，而要创建的.gitignore文件是没有文件名的，所以我们可以使用move命令来实现，打开Git Bash ，使用mv gitignore.txt .gitignore，然后用编辑器编辑这个文件。

语法规范

1、 #：开头的行表示注释行
2、：用来匹配零个或多个字符
3、.a表示忽略.a文件；
.[oa]表示忽略所有以.a和.o结尾的文件，_{忽略所有以}结尾的文件；
[]用来匹配括号内的任一字符，如[abc]，也可以在括号内加连接符，如[0-9]匹配0至9的数；
?用来匹配单个字符；
4、!：用来否定忽略
比如前面用了.txt，然后使用!a.txt，则这个a.txt不会被忽略
5、/：
正斜杠在前：匹配项目跟目录；如/bin表示忽略根目录下的bin文件，/bsp表示忽略根目录下的bsp文件夹， 但不忽略子目录里的user/bsp文件夹；
正斜杠在后：匹配文件夹以及在该文件夹路径下的内容，但是不匹配该文件；如bsp/表示忽略bsp文件夹里的所有文件；
6、**：匹配多级目录，可在开始，中间，结束；

忽略优先级

在.gitignore文件中，每一行指定一个忽略规则，Git 检查忽略规则的时候有多个来源，它的优先级如下（由高到低）：

1、从命令行中读取可用的忽略规则
2、当前目录定义的规则
3、父级目录定义的规则，依次递推
4、$GIT_DIR/info/exclude 文件中定义的规则
5、core.excludesfile中定义的全局规则

Django项目建议忽略的文件清单

一般缓存文件__pycache__和本地日志文件.log不需要提交。media文件夹和db.sqlite3文件可能包括了本地测试数据和文件，也不要提交。PyCharm生成的文件， Env文件第三方package也不要提交。下列文件和文件夹建议忽略。

# Django #

*.log

*.pot

*.pyc

__pycache__

db.sqlite3

media

# Backup files #

*.bak

# If you are using PyCharm #

.idea

*.iws /out/

# Python #

*.py[cod]

*$py.class

# Distribution / packaging

.Python build/

develop-eggs/

dist/

downloads/

eggs/

.eggs/

lib/

lib64/

parts/

sdist/

var/

wheels/

*.egg-info/

.installed.cfg

*.egg

*.manifest

*.spec

# Installer logs

pip-log.txt

pip-delete-this-directory.txt

# Unit test / coverage reports

htmlcov/

.tox/

.coverage

.coverage.*

.cache

.pytest_cache/

nosetests.xml

coverage.xml

*.cover

.hypothesis/

# pyenv

.python-version

# celery

celerybeat-schedule.*

# SageMath parsed files

*.sage.py

# Environments

.env

.venv

env/

venv/

ENV/

env.bak/

venv.bak/

# mkdocs documentation

/site

# mypy

.mypy_cache/

# Sublime Text #

*.tmlanguage.cache

*.tmPreferences.cache

*.stTheme.cache

*.sublime-workspace

*.sublime-project

# sftp configuration file

sftp-config.json

# Package control specific files Package

Control.last-run

Control.ca-list

Control.ca-bundle

Control.system-ca-bundle

GitHub.sublime-settings

.gitignore规则不生效

一、gitignore只能忽略那些原来没有被追踪（tracked）的文件，如果某些文件已经被纳入了版本管理中，则修改.gitignore是无效的。
解决方法就是先把本地缓存删除（改变成未track状态），然后再提交:

1. git rm -r --cached .
2. git add .
3. git commit -m 'update .gitignore'

二、你想添加一个文件到Git，但发现添加不了，原因是这个文件被.gitignore忽略了：

$ git add App.class
The following paths are ignored by one of your .gitignore files:
App.class
Use -f if you really want to add them.

如果你确实想添加该文件，可以用-f强制添加到Git：

$ git add -f App.class

三、或者你发现，可能是.gitignore写得有问题，需要找出来到底哪个规则写错了，可以用git check-ignore命令检查：

$ git check-ignore -v App.class
.gitignore:3:*.class    App.class

Git会告诉我们，.gitignore的第3行规则忽略了该文件，于是我们就可以知道应该修订哪个规则。