Git 系列教程（5）- 记录每次更新到仓库

文件状态

你工作目录下的每一个文件只有两种状态：tracked 或 untracked

tracked

已跟踪 tracked 的文件是指那些被纳入了版本控制的文件
在上一次快照中有它们的记录，在工作一段时间后，它们的状态可能是未修改unmodified、已修改modified 或已放入暂存区staged
简单来说，已跟踪 tracked 的文件就是 Git 知道的文件

untracked

工作目录中除 tracked 文件外的其它所有文件都属于 untracked 文件
它们既不存在于上次快照的记录中，也没有被放入暂存区
初次 clone 某个仓库的时候，工作目录中的所有文件都属于 tracked 文件，并处于 unmodified
编辑文件后，Git 将它们标记为 modified 文件。在工作时，你可以选择性地将这些修改过的文件放入暂存区，然后提交所有已暂存的修改

文件的状态变化周期

检查当前文件状态

可以用 git status 命令查看哪些文件处于什么状态。如果在克隆仓库后立即使用此命令，会看到类似这样的输出：

git status

On branch master

Your branch is up-to-date with 'origin/master'.

nothing to commit, working directory clean

可以获取到的内容

所有 tracked 件在上次提交后都未被更改过
当前目录下没有出现任何 untracked 的新文件，否则 Git 会在这里列出来
还显示了当前所在分支，并告诉你这个分支同远程服务器上对应的分支没有偏离，现在，分支名是“master”，这是默认的分支名

在项目下创建一个新的 README 文件，使用 git status 命令，将看到一个新的 untracked 文件

echo 'My Project' > README

$ git status

On branch master

Your branch is up-to-date with 'origin/master'.

Untracked files:

  (use "git add <file>..." to include in what will be committed)

    README

nothing added to commit but untracked files present (use "git add" to track)

可以获取到的内容

README 文件出现在 Untracked files 下面
untracked 的文件意味着 Git 在之前的快照（提交）中没有这些文件

如何跟踪

git add 文件名

# 更新目录下所有文件

git add .

后面会再详细讲这个命令

跟踪新文件

使用命令 git add 开始跟踪一个文件。所以，要跟踪 README 文件，运行：

git add README

此时再运行 git status 命令，会看到 README 文件已被跟踪，并处于 staged

git status

On branch master

Your branch is up-to-date with 'origin/master'.

Changes to be committed:

  (use "git restore --staged <file>..." to unstage)

    new file:   README

可以获取到的内容

只要在 Changes to be committed 这行下面的，就说明是 staged 状态
如果此时提交，那么该文件在你运行 git add 时的版本将被留存在后续的历史记录中

暂存已修改的文件

如果修改了一个名为 CONTRIBUTING.md 的已被 tracked 的文件，然后运行 git status 命令，会看到下面内容

git status

On branch master

Your branch is up-to-date with 'origin/master'.

Changes to be committed:

  (use "git reset HEAD <file>..." to unstage)

    new file:   README

Changes not staged for commit:

  (use "git add <file>..." to update what will be committed)

  (use "git checkout -- <file>..." to discard changes in working directory)

    modified:   CONTRIBUTING.md

可以获取到的内容

CONTRIBUTING.md 出现在 Changes not staged for commit 这行下面，说明已跟踪文件的内容发生了变化，但还没有放到暂存区
要暂存这次更新，需要运行 git add 命令

再次运行 git add 命令

运行 git add 将“CONTRIBUTING.md”放到暂存区，然后再看看 git status 的输出：

$ git add CONTRIBUTING.md

$ git status

On branch master

Your branch is up-to-date with 'origin/master'.

Changes to be committed:

  (use "git reset HEAD <file>..." to unstage)

    new file:   README

    modified:   CONTRIBUTING.md

再次修改文件内容

编辑 CONTRIBUTING.md，再运行 git status 看看

$ vim CONTRIBUTING.md

$ git status

On branch master

Your branch is up-to-date with 'origin/master'.

Changes to be committed:

  (use "git reset HEAD <file>..." to unstage)

    new file:   README

    modified:   CONTRIBUTING.md

Changes not staged for commit:

  (use "git add <file>..." to update what will be committed)

  (use "git checkout -- <file>..." to discard changes in working directory)

    modified:   CONTRIBUTING.md

可以获取到的内容

CONTRIBUTING.md 文件同时出现在暂存区和非暂存区
实际上 Git 只不过暂存了运行 git add 命令时的版本
如果你现在提交代码，CONTRIBUTING.md 的版本是你最后一次运行 git add 命令时的那个版本，而不是当前版本
所以，运行了 git add 之后又编辑了文件，需要再次 git add 把最新版本暂存

$ git add CONTRIBUTING.md

$ git status

On branch master

Your branch is up-to-date with 'origin/master'.

Changes to be committed:

  (use "git reset HEAD <file>..." to unstage)

    new file:   README

    modified:   CONTRIBUTING.md

真实的实际操作栗子

状态简述

git status 命令的输出十分详细，但其用语有些繁琐
git status -s 或 git status --short ，输出结果更加简洁

git status -s

 M markers.py

 M test.py

D  test_func01.py

D  test_login.py

?? text.txt

忽略文件

https://www.cnblogs.com/poloyy/p/12342073.html

查看已暂存和未暂存的修改

修改 README 文件后暂存，然后编辑 CONTRIBUTING.md 文件后先不暂存，运行 status 命令将会看到：

$ git status

On branch master

Your branch is up-to-date with 'origin/master'.

Changes to be committed:

  (use "git reset HEAD <file>..." to unstage)

    modified:   README

Changes not staged for commit:

  (use "git add <file>..." to update what will be committed)

  (use "git checkout -- <file>..." to discard changes in working directory)

    modified:   CONTRIBUTING.md

初次使用 git diff

要查看尚未暂存的文件更新了哪些部分，不加参数直接输入 git diff：

$ git diff

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md

index 8ebb991..643e24f 100644

--- a/CONTRIBUTING.md

+++ b/CONTRIBUTING.md

@@ -65,7 +65,8 @@ branch directly, things can get messy.

 Please include a nice description of your changes when you submit your PR;

 if we have to read the whole diff to figure out why you're contributing

 in the first place, you're less likely to get feedback and have your change

-merged in.

+merged in. Also, split your changes into comprehensive chunks if your patch is

+longer than a dozen lines.

 If you are starting to work on a particular area, feel free to submit a PR

 that highlights your work in progress (and note in the PR title that it's

实际栗子

git diff 的作用

比较的是当前文件和暂存区快照之间的差异，也就是修改之后还没有暂存起来的变化内容
若要查看已暂存且要添加到下次提交里的内容，可以用 git diff --staged 命令
会比较已暂存文件与最后一次提交的文件差异

$ git diff --staged

diff --git a/README b/README

new file mode 100644

index 0000000..03902a1

--- /dev/null

+++ b/README

@@ -0,0 +1 @@

+My Project

git diff

git diff 本身只显示尚未暂存的改动，而不是自上次提交以来所做的所有改动，所以有时候一下子暂存了所有更新过的文件，运行 git diff 后却什么也没有

像之前说的，暂存 CONTRIBUTING.md 后再编辑，可以使用 git status 查看已被暂存的修改或未被暂存的修改。如果我们的环境（终端输出）看起来如下：

$ git add CONTRIBUTING.md

$ echo '# test line' >> CONTRIBUTING.md

$ git status

On branch master

Your branch is up-to-date with 'origin/master'.

Changes to be committed:

  (use "git reset HEAD <file>..." to unstage)

    modified:   CONTRIBUTING.md

Changes not staged for commit:

  (use "git add <file>..." to update what will be committed)

  (use "git checkout -- <file>..." to discard changes in working directory)

    modified:   CONTRIBUTING.md

现在运行 git diff 看暂存前后的变化：

$ git diff

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md

index 643e24f..87f08c8 100644

--- a/CONTRIBUTING.md

+++ b/CONTRIBUTING.md

@@ -119,3 +119,4 @@ at the

 ## Starter Projects

 See our [projects list](https://github.com/libgit2/libgit2/blob/development/PROJECTS.md).

+# test line

然后用 git diff --cached 查看已经暂存起来的变化（ --staged 和 --cached 是同义词）：

$ git diff --cached

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md

index 8ebb991..643e24f 100644

--- a/CONTRIBUTING.md

+++ b/CONTRIBUTING.md

@@ -65,7 +65,8 @@ branch directly, things can get messy.

 Please include a nice description of your changes when you submit your PR;

 if we have to read the whole diff to figure out why you're contributing

 in the first place, you're less likely to get feedback and have your change

-merged in.

+merged in. Also, split your changes into comprehensive chunks if your patch is

+longer than a dozen lines.

 If you are starting to work on a particular area, feel free to submit a PR

 that highlights your work in progress (and note in the PR title that it's

实际栗子

提交更新

现在的暂存区已经准备就绪，可以提交了
在此之前，请务必确认还有什么已修改或新建的文件还没有 git add 过，否则提交的时候不会记录这些尚未暂存的变化
这些已修改但未暂存的文件只会保留在本地磁盘
所以，每次准备提交前，先用 git status 看下，你所需要的文件是不是都已暂存起来了，然后再运行提交命令 git commit：

git commit -m "test"

可以获取到的内容

commit 之后 git status 可以看到本地是干净的
提交后会显示当前是在哪个分支（master）提交的
本次提交的完整 SHA-1 校验和是什么（9a8c6b3）
以及在本次提交中，有多少文件修订过，多少行添加和删改过

重点

提交时（git commit）记录的是放在暂存区域的快照
每一次运行提交操作，都是对项目作一次快照，以后可以回到指定快照版本，或者进行比较

跳过使用暂存区域

Git 提供了一个跳过使用暂存区域的方式
git commit 加上 -a 选项，Git 就会自动把所有已经跟踪过的文件暂存起来一并提交，从而跳过 git add 步骤

-a 选项使本次提交包含了所有修改过的文件，但是要小心，有时这个选项会将不需要的文件添加到提交中

移除文件

两种情况

直接删除文件（从本地删除）：-f 参数
只是将文件从 Git 的暂存区移除，并不会删除本地文件：--cached

直接看栗子

已跟踪的文件（出现在暂存区）的文件被执行 git rm --cached 命令后，它会被移出暂存区，重新变成一个未跟踪的文件

移动文件

在 Git 中对文件改名

$ git mv file_from file_to

查看状态信息，也会看到关于重命名操作的说明

文件会自动提交到暂存区，且不需要手动执行 git add

其实，运行 git mv 就相当于运行了下面三条命令

$ mv README.md README

$ git rm README.md

$ git add README