Git新手教程-添加忽略文件(十)

title.jpg

前言

通过前面的文章,我相信大家已经对 Git 有所掌握了,现在还剩下最后一个知识点,就是让 Git 添加忽略某些文件。在实际的项目开发中,我们可能不想将一些文件添加到 Git 仓库中。比如,一些敏感文件、临时文件、自动生成文件、日志文件等。那应该怎么操作呢?

实际例子

假设我们想创建一个项目并使用 Git 进行管理,现在我们有三个文件 A.mdB.mdC.md,现在我们不希望将 C.md文件添加到仓库中。但是 Git 会看到这些文件,所以在我们运行 git status 命令时,它仍然会显示在文件列表中:

下图中的项目 GitTestProject 项目,已经通过 git init 初始化过了。

忽略文件1.png

那这个时候我们应该怎么办呢?如果我们想某个文件保留在项目中,又不想它受到 Git 的跟踪管理,那我们可以使用文件 .gitignore 文件,我们只需要创建该文件,然后并添加到我们项目的根目录中,最后把你想要忽略(让 Git 不进行跟踪)的文件名称填写到该文件中就可以了。如果我们要忽略 C.md 我们可以将这行添加到 .gitignore 文件中。

在 Mac 系统中不能直接创建 .gitignore 文件,我们需要在当前项目的根目录打开控制台,并输入 touch .gitignore 来生成 .gitignore 文件。

C.md

这时我们再使用 git status 来查看我们的仓库的状态:

忽略文件2.png

从上图中,我们可以发现 C.md文件已经不再受 Git 控制了。因为 Git 会查看 .gitignore 文件中的内容,并根据该文件中的内容,自动忽略你想忽略的文件。

那既然 C.md文件已经被忽略了,那么我们就可以直接使用 git add . 来添加当前目录的所有文件啦。

还记得之前章节中我们学习的 git add命令吗?我们可以使用一个特殊的字符来表示当前目录和所有的子目录,而不是一个个的添加文件。还记得是什么字符吗?对就是 .(点)

忽略文件通配符

虽然我们可以直接在 .gitignore 文件中直接书写我们要忽略的文件名称,但是我们也可以使用 通配符 来忽略一系列满足条件的文件或文件夹。

通配符允许你使用特殊的字符来表示某些格式/字符。在 .gitignore 文件中,我们可以使用:

  • 空白行作为空格
  • # : 将行标记为注释
  • * : 与 0 个或多个字符匹配
  • ? :与 1 个字符匹配
  • [abc] : - 与 a、b 或 c 匹配
  • ** : 与嵌套目录匹配,比如 a/**/z 与以下项匹配
    • a/z
    • a/b/z
    • a/b/c/z

下面我们来看一些简单的例子来学习一下通配符的使用,比如我们需要忽略当前项目根目下的 A 文件夹中的所有的 80 张 PNG 格式的图片,我们可以在 .gitignore 文件中书写:

/A/*.png

注意:Git 默认会忽略文件名的大小写,我们可使用命令 git config --get core.ignorecase 来查看我们的设置,当然我们也可以通过命令 git config core.ignorecase false 将其置为 false 。

常见问题

现在我们已经学会如何在 Git 中添加忽略文件了,但是在使用的过程中,以下几个问题我们也是会常常遇见的。

不能将文件添加到 git 仓库

有些时候,我们想添加一个文件到仓库中,但是我们发现我们添加不了,原因是这个文件已经被添加到 .gitignore 文件中忽略了。比如结合上述例子,我们想添加 C.md 文件,会有如下提示:

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

如果我们确实需要添加该文件,那么我们可以使用 -f 选项来强制添加。

git add -f C.md

通过 -f 选项强制添加的文件,在后续的使用中与其他正常被 Git 跟踪的文件使用效果一样。也就是说 C.md 文件将会受到 Git 的跟踪管理。

如果你觉得 gitignore 中的忽略文件的书写有误,我们也可以使用 git check-ignore 来查看我们的忽略文件的规则:

git check-ignore -v c.md
.gitignore:1:C.md c.md

关于该命令的更多介绍,可以查看官方文档git-check-ignore

已经添加到暂存区中的文件如何忽略

还是结合我们上述的例子,在项目中,我们忘记了在 .gitignore 文件中添加忽略文件 C.md,直接使用了 gid add . 命令,将所有的文件都添加到了暂存区中,如下所示:

忽略文件3.png

那么这个时候,我们可以使用 git rm --cached 命令,将 C.md 文件从暂存区中移除:

关于 git rm 命令的使用,可以查看官方文档git rm

git rm --cached C.md

这个时候,我们在使用 git status 命令来仓库我们的仓库的状态,我们会发现 C.md 文件已经从暂存区中移除了。

忽略文件4.png

那么接下来,我们就可以修改我们的 .gitignore 文件,将 C.md 添加到该忽略文件中去了。

已经被跟踪文件如何忽略

不仅将文件添加到 Git 仓库,还推送到远程仓库了。并且其他合作的小伙伴已经从远程仓库拉取了更新。这个时候才发现某些文件需要忽略。

这种情况下,如果我们再将想忽略的文件添加到 .gitignore 文件中,已经完全不起任何作用了。

那怎么办呢?我们可以使用另外一个命令:

git update-index --assume-unchanged <file>

还是以上文中的 C.md 为例子,我们可以这样:

git update-index --assume-unchanged C.md

使用该命令后,即使我们修改了已经被跟踪的 C.md 文件,Git 也会默认我们没有更改该文件。什么意思呢?也就是我们本地随便修改该文件,Git 始终认为它和原来的版本一样。那么在之后的项目开发中,就不会产生包含该文件的提交了。

同样,我们也可以恢复对该文件的追踪,我们可以使用命令:

git update-index --no-assume-unchanged <file>

关于该命令的使用,可以查看官方文档--no-assume-unchanged

小小的建议

通过阅读本篇文章,相信小伙伴已经意识到了找准正确的时间,添加忽略文件是多么的重要。这里需要提醒第一次使用 Git 或其他版本管理系统的小伙伴们。在创建仓库时,一定要先处理忽略文件,也就是你的 .gitignore 文件一定要在项目初始化完成后提交!!!! 因为后期再来处理忽略文件,就非常的麻烦与复杂。

所以在平时的项目中,一定要确定自己项目中哪些文件到底应该被追踪,哪些应该不被追踪。以 Android 项目为例:

*.iml
.gradle
/local.properties
/.idea/workspace.xml
/.idea/libraries
.DS_Store
/build
/captures
.externalNativeBuild

上述忽略文件是一般 Android 项目都会设置,因为这些都是一些配置文件、中间文件、项目配置文件等。当然不同的项目所需要配置的忽略文件并不相同,大家可以结合自身的需求来配置。这里就不具体讲解其他项目的忽略文件的配置了。

最后

整个 Git 新手系列教程,到现在已经写完了,虽然前前后后花费了一个月的时间,但是当自己完成后,却忍不住的满足与自豪。不是自己涨了好多粉丝,而是为自己能坚持做一件事而感到高兴。给自己定一个小目标,一步一步实现的感觉真好~

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,425评论 4 361
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,058评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,186评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,848评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,249评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,554评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,830评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,536评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,239评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,505评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,004评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,346评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,999评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,060评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,821评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,574评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,480评论 2 267

推荐阅读更多精彩内容

  • 在使用Git的过程中,我们喜欢有的文件比如日志,临时文件,编译的中间文件等不要提交到代码仓库,这时就要设置相应的忽...
    yichen_china阅读 875评论 0 3
  • 什么是git版本管理控制工具(vcs) 1.分布式版本控制 2.多个开发人员协调工作 3.有效监听谁做的修改 4....
    Daryl_Z阅读 578评论 1 2
  • 一、基本概念: 注:对于git的分布式概念及其优点,不重复说明,自己百度或谷歌。本文中涉及到指令前面有$的,在cm...
    大厂offer阅读 1,335评论 0 3
  • 有很多文件不必使用git管理。例如Eclipse或其他IDE生成的项目文件,编译生成的各种目标或临时文件等。 使用...
    Ten_Minutes阅读 2,079评论 0 4
  • 2. Git 基础 写在前面:这一部分内容真的是好多好多好多ε(┬┬﹏┬┬)3,不过也是使用 Git 最有用的啦,...
    sylvia_yue阅读 304评论 0 2