Git忽略规则:.gitignore配置

admin8个月前笔记72
.gitignore文件

一般来说每个Git项目中都需要一个“.gitignore”文件,这个文件的作用就是告诉Git哪些文件不需要添加到版本管理中。实际项目中,很多文件都是不需要版本管理的,比如Python的.pyc文件和一些包含密码的配置文件等等。这个文件的内容是一些规则,Git会根据这些规则来判断是否将文件添加到版本控制中。这样,被过滤掉的文件就不会出现在git仓库中(gitlab或github)了,当然本地库中还有,只是push的时候不会上传。

需要注意的是如果你不慎在创建.gitignore文件之前就push了项目,那么即使你在.gitignore文件中写入新的过滤规则,这些规则也不会起作用,Git仍然会对所有文件进行版本管理。简单来说,出现这种问题的原因就是Git已经开始管理这些文件了,所以你无法再通过过滤规则过滤它们。因此一定要养成在项目开始就创建.gitignore文件的习惯,否则一旦push,处理起来会非常麻烦。

.gitignore配置文件用于配置不需要加入版本管理的文件,配置好该文件可以为版本管理带来很大的便利。

配置规则

空行或是以#开头的行为注释;
前面添加正斜杠/避免递归;
后面添加正斜杠/忽略目录;
*匹配零个或多个字符;
?匹配单个字符;
[]匹配括号内的任一字符;
!表示不忽略(跟踪)匹配到的文件或目录;
下面我们看一些例子来理解上面的规则:

# 忽略 .a 文件 不管是当前目录下还是子目录下的 .a 文件都忽略
*.a
# 但否定忽略 lib.a, 尽管已经在前面忽略了 .a 文件
!lib.a
# 忽略 m.b 文件,不忽略 mc.b
?.b
# 忽略当前目录下 TODO 文件,但不包括子目录下的 subdir/TODO
/TODO
# 忽略 build/ 目录下的所有文件 不管是当前目录下的 build/ 还是子目录下的 build/ 都忽略
build/
# 忽略当前目录下的 now/ 目录
/now/
[abc]	# 匹配a、b、c
[0-9]	# 匹配0至9的数
# 忽略 test/c.p, 不包括 server/test/c.p
test/*.p
# 忽略所有的 .pdf 文件 在 doc/ directory 下
doc/*/*.pdf
注意事项

配置文件的完整文件名就是".gitignore",注意最前面有个“.”;
配置文件是按行从上到下进行规则匹配的,如果前面的规则匹配的范围更大,则后面的规则将不会生效;
该文件只能作用于Untracked Files,也就是那些从来没有被 Git 记录过的文件(自添加以后,从未 add 及 commit 过的文件);
如果文件曾经被 Git 记录过,那么.gitignore就对它们完全无效。

配置样例

下面给出一个以Python开发为例的配置文件样例,更多配置请参考GitHub上gitignore仓库。

.
# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class

# C extensions
*.so

# Distribution / packaging
.Python
build/
develop-eggs/
dist/
downloads/
eggs/
.eggs/
lib/
lib64/
parts/
sdist/
var/
wheels/
*.egg-info/
.installed.cfg
*.egg
MANIFEST

# PyInstaller
#  Usually these files are written by a python script from a template
#  before PyInstaller builds the exe, so as to inject date/other infos into it.
*.manifest
*.spec

# Installer logs
pip-log.txt
pip-delete-this-directory.txt

# Unit test / coverage reports
htmlcov/
.tox/
.coverage
.coverage.*
.cache
nosetests.xml
coverage.xml
*.cover
.hypothesis/
.pytest_cache/

# Translations
*.mo
*.pot

# Django stuff:
*.log
local_settings.py
db.sqlite3

# Flask stuff:
instance/
.webassets-cache

# Scrapy stuff:
.scrapy

# Sphinx documentation
docs/_build/

# PyBuilder
target/

# Jupyter Notebook
.ipynb_checkpoints

# pyenv
.python-version

# celery beat schedule file
celerybeat-schedule

# SageMath parsed files
*.sage.py

# Environments
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/

# Spyder project settings
.spyderproject
.spyproject

# Rope project settings
.ropeproject

# mkdocs documentation
/site

# mypy
.mypy_cache/


相关文章

Git bisect 命令帮助定位首次引入错误的提交

Git bisect 命令帮助定位首次引入错误的提交

你是不是有过这样的经历:发现代码中有 错误bug,但不知道这个错误是什么时候引入的。这有可能是因为,某个人提交了一份有错误的代码,但没有在他的 Git 提交commit 消息中声明它。这个错误可能已经...

Linux压缩好帮手bzip2

Linux压缩好帮手bzip2

Linux 中有几个文件压缩和解压缩工具,比如gzip、7-zip、Lrzip、PeaZip 等等。本篇教程中,我们将介绍如何在 Linux 中使用 bzip2 工具压缩及解压缩.bz2文件...

聊聊服务器优化

聊聊服务器优化

我们开发的软件服务需要在服务器上运行,所以服务器性能代表了软件的性能上限,因此服务器性能调优是个十分重要的环节,然而大部分同学对服务器性能调优关注的较少,今天从3个部分对服务器性能调优进行介绍,分别是...

一键搭建web版chatGPT,无需魔法,国内可用

一键搭建web版chatGPT,无需魔法,国内可用

在GitHub上有很多web版本的ChatGPT项目,感谢这些开源作者,我们能很方便的搭建属于自己的ChatGPT。前置条件需要拥有chatGPT的api key。申请地址platform.opena...

介绍Linux下的 Tun/Tap

介绍Linux下的 Tun/Tap

什么是Tun/TapTAP等同于一个以太网设备,它操作第二层数据包如以太网数据帧。TUN模拟了网络层设备,操作第三层数据包比如IP数据封包。操作系统通过TUN/TAP设备向绑定该设备的用户空间的程序发...

MySQL利用逻辑备份恢复误删的数据库

前言本篇文章介绍了MySQL数据库中误删库后,使用逻辑备份完全恢复方法的一种方法。此方法的一个前提条件是数据库打开了binlog,在生产环境中强烈建议打开binlog。这相当于数据库的归档,虽然占用了...

发表评论    

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。