git基础

仓库状态查看

git status命令

git status显示详细信息
git status -s 显示简要信息

git status -s说明

??和

提交文件

跳过git add

git commit 加上 -a 选项，Git 就会自动把所有【已经跟踪过】的文件暂存起来一并提交，从而跳过 git add 步骤,即：

1	git commit -am 'commit xxx'

注意，未被追踪过的数据不会被git commit -am提交

删除文件

方法1 先删除，然后使用git rm记录

如果只是简单地从工作目录中手工删除文件，运行 git status 时就会在 “Changes not staged for commit” 部分（也就是未暂存清单）看到，然后再运行 git rm 记录此次移除文件的操作，此时文件的状态才会变为Changes to be committed（即：删除操作被暂存）

其实使用git add也可以用来记录删除操作，比如：

86182@yawen MINGW64 /d/coding/git-playground (master)
$ rm download.c # 直接删除工作区文件（注意是直接删除，不是通过git rm命令删除）

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git status
On branch master
Changes not staged for commit: # 提示删除操作尚未添加到暂存区
  (use "git add/rm <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        deleted:    download.c

no changes added to commit (use "git add" and/or "git commit -a")

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git add download.c # 通过git add也可以记录删除操作

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git status
On branch master
Changes to be committed: # 已经将删除文件的操作添加到暂存区
  (use "git restore --staged <file>..." to unstage)
        deleted:    download.c

方法2 使用git rm（暂存区中没有改动）

针对暂存区中没有改动的文件，可以直接使用git rm删除

86182@yawen MINGW64 /d/coding/git-playground (master)
$ ll
total 3
-rw-r--r-- 1 86182 197609 20  3月 21 09:21 CONTRIBUTING.md
-rw-r--r-- 1 86182 197609  0  3月 21 10:35 download.c
-rw-r--r-- 1 86182 197609  0  3月 20 16:14 LICENSE
-rw-r--r-- 1 86182 197609  4  3月 20 16:34 main.c
-rw-r--r-- 1 86182 197609  0  3月 20 16:36 out.a
-rw-r--r-- 1 86182 197609  0  3月 20 16:36 out.o
-rw-r--r-- 1 86182 197609 21  3月 21 09:28 README

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git status
On branch master
nothing to commit, working tree clean

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git rm download.c # 通过git rm直接删除
rm 'download.c'

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git status
On branch master
Changes to be committed:  # 此时删除操作直接被记录到暂存区
  (use "git restore --staged <file>..." to unstage)
        deleted:    download.c

注意：如果使用git rm删除尚未追踪的文件，会报错fatal: pathspec 'xxx' did not match any files，比如：

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git status
On branch master
Untracked files:
  (use "git add <file>..." to include in what will be committed)
        README.md # 尚未被追踪的文件（即：仅存在与工作区）

no changes added to commit (use "git add" and/or "git commit -a")

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git rm README.md # 尝试通过git rm删除
fatal: pathspec 'README.md' did not match any files

方法3 使用git rm -f(暂存区中有改动)

如果删除之前修改过并且已经放到暂存区的话，则必须要用强制删除选项 -f,否则会提示如下错误：

1	error: the following file has changes staged in the index

这是一种安全特性，用于防止误删还没有添加到快照的数据，这样的数据不能被 Git 恢复。比如

86182@yawen MINGW64 /d/coding/git-playground (master)
$ vim fetch.js # 修改文件

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git status
On branch master
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   fetch.js

no changes added to commit (use "git add" and/or "git commit -a")

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git add fetch.js # 添加到暂存区

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git status
On branch master
Changes to be committed: # 改动已经保存到暂存区
  (use "git restore --staged <file>..." to unstage)
        modified:   fetch.js

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git rm fetch.js # 尝试不添加-f参数直接删除文件
error: the following file has changes staged in the index: # 报错
    fetch.js
(use --cached to keep the file, or -f to force removal)

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git rm -f fetch.js
rm 'fetch.js'

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git status
On branch master
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        deleted:    fetch.js

差异对比

查看尚未暂存部分的差异

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

查看已暂存部分的差异

若要查看已暂存的将要添加到下次提交里的内容，可以用 git diff --cached 命令。（Git 1.6.1 及更高版本还允许使用 git diff --staged，效果是相同的，但更好记些。）

–staged 和 --cached

--staged 和 --cached 是同义词

移动（重命名）文件

不像其它的 VCS 系统，Git 并不显式跟踪文件移动操作。如果在 Git 中重命名了某个文件，仓库中存储的元数据并不会体现出这是一次改名操作。

比如直接通过操作系统重命名一个文件（注意不是git mv）:

86182@yawen MINGW64 /d/coding/git-playground (master)
$ mv README README.md # 直接通过系统mv命令重命名

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git status
On branch master
Changes not staged for commit:
  (use "git add/rm <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        deleted:    README

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        README.md

no changes added to commit (use "git add" and/or "git commit -a")

可以看到，git并不认为这是一个重命名操作，而是认为我们：

删除了README文件
新增了一个README.md文件

如果希望git明确的记录重命名操作，可以通过git mv实现，比如同样的操作：

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git mv README README.md

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git status
On branch master
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        renamed:    README -> README.md # 记录的操作类型为rename

git mv相当于如下三条命令：

1
2
3

mv README README.md
git rm README
git add README.md

查看提交历史

基础用法

在提交了若干更新，又或者克隆了某个项目之后，你也许想回顾下提交历史。完成这个任务最简单而又有效的工具是 git log 命令，比如：

$ git log
commit 32b941f804b460b97ba5bc8fc87db57fda654018 (HEAD -> master)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 10:59:17 2024 +0800

    重命名Readme.md

commit 8baa8018574dd11181d5b4943f70c1ad69ee6a49
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 09:55:34 2024 +0800

    删除fetch.js

显示每次提交的内容差异(-p选项)

默认情况下，git log不会生成任何diff的输出（见上），一个常用的选项是 -p，用来显示每次提交的内容差异，比如：

$ git log -p
commit 32b941f804b460b97ba5bc8fc87db57fda654018 (HEAD -> master)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 10:59:17 2024 +0800

    重命名Readme.md

diff --git a/README b/README.md
similarity index 100%
rename from README
rename to README.md

commit 8baa8018574dd11181d5b4943f70c1ad69ee6a49
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 09:55:34 2024 +0800

    删除fetch.js

diff --git a/fetch.js b/fetch.js
deleted file mode 100644
index e69de29..0000000

该选项除了显示基本信息之外，还附带了每次 commit 的变化。

你也可以加上 -2 来仅显示最近两次提交，比如：

86182@yawen MINGW64 /d/coding/git-playground (master)
$ git log -p -2
commit 32b941f804b460b97ba5bc8fc87db57fda654018 (HEAD -> master)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 10:59:17 2024 +0800

    重命名Readme.md

diff --git a/README b/README.md
similarity index 100%
rename from README
rename to README.md

commit 8baa8018574dd11181d5b4943f70c1ad69ee6a49
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 09:55:34 2024 +0800

    删除fetch.js

diff --git a/fetch.js b/fetch.js
deleted file mode 100644
index e69de29..0000000

查看每次提交的简略信息（–stat）

--stat 选项在每次提交的下面列出所有被修改过的文件、有多少文件被修改了以及被修改过的文件的哪些行被移除或是添加了。,在每次提交的最后还有一个总结。

$ git log --stat -1
commit 32b941f804b460b97ba5bc8fc87db57fda654018 (HEAD -> master)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 10:59:17 2024 +0800

    重命名Readme.md

 README => README.md | 0
 1 file changed, 0 insertions(+), 0 deletions(-)

美化输出(–pretty)

另外一个常用的选项是 --pretty。这个选项可以指定使用不同于默认格式的方式展示提交历史。这个选项有一些内建的子选项供你使用。比如用 oneline 将每个提交放在一行显示，查看的提交数很大时非常有用，比如：

$ git log --pretty=oneline
32b941f804b460b97ba5bc8fc87db57fda654018 (HEAD -> master) 重命名Readme.md
8baa8018574dd11181d5b4943f70c1ad69ee6a49 删除fetch.js
9990b44a8dea55760322c98cfe7868b15dd4356f 删除robot.txt
de8fb678dacd2e15ac9ad8f37f6bd7889311ffda 添加robot.txt
2ae831bc8513981ea3bd5e49b80e472d4a3c1fd0 直接使用-am参数提交
6b40dfc09d3710513629e85af3cbe88ac9123fd0 提交CONTRIBUTING.md
15ba6d001ccf53b1979c16556691cf8b49860e03 修改md
2e623a603ecb35719a07b481b141137b511607a0 提交.gitignore
f496a0ffda4529059acca55508b56e99e15a5f02 新增文件
3b4a7a8b032a2a78637a0ff9c8e1becff6243075 新增 new file:   CONTRIBUTING.m
351876e11887dd9d63cf66670737696618860c1e initial project version

还可以直接通过git log --online查看简要输出：

$ git log --oneline
32b941f (HEAD -> master) 重命名Readme.md
8baa801 删除fetch.js
9990b44 删除robot.txt
de8fb67 添加robot.txt
2ae831b 直接使用-am参数提交
6b40dfc 提交CONTRIBUTING.md
15ba6d0 修改md
2e623a6 提交.gitignore
f496a0f 新增文件
3b4a7a8 新增 new file:   CONTRIBUTING.m
351876e initial project version

另外还有 short，full 和 fuller 可以用，展示的信息或多或少有些不同:

比如short:

$ git log --pretty=short -2
commit 32b941f804b460b97ba5bc8fc87db57fda654018 (HEAD -> master)
Author: slimterry <slimterry@qq.com>

    重命名Readme.md

commit 8baa8018574dd11181d5b4943f70c1ad69ee6a49
Author: slimterry <slimterry@qq.com>

    删除fetch.js

fuller：

$ git log --pretty=fuller
commit 32b941f804b460b97ba5bc8fc87db57fda654018 (HEAD -> master)
Author:     slimterry <slimterry@qq.com>
AuthorDate: Thu Mar 21 10:59:17 2024 +0800
Commit:     slimterry <slimterry@qq.com>
CommitDate: Thu Mar 21 10:59:17 2024 +0800

    重命名Readme.md

commit 8baa8018574dd11181d5b4943f70c1ad69ee6a49
Author:     slimterry <slimterry@qq.com>
AuthorDate: Thu Mar 21 09:55:34 2024 +0800
Commit:     slimterry <slimterry@qq.com>
CommitDate: Thu Mar 21 09:55:34 2024 +0800

    删除fetch.js

但最有意思的是 format，可以定制要显示的记录格式。这样的输出对后期提取分析格外有用 — 因为输出的格式不会随着 Git 的更新而发生改变,比如：

$ git log --pretty=format:"%h - %an, %ar : %s"
32b941f - slimterry, 29 minutes ago : 重命名Readme.md
8baa801 - slimterry, 2 hours ago : 删除fetch.js
9990b44 - slimterry, 2 hours ago : 删除robot.txt
de8fb67 - slimterry, 2 hours ago : 添加robot.txt
2ae831b - slimterry, 2 hours ago : 直接使用-am参数提交
6b40dfc - slimterry, 2 hours ago : 提交CONTRIBUTING.md
15ba6d0 - slimterry, 2 hours ago : 修改md
2e623a6 - slimterry, 19 hours ago : 提交.gitignore
f496a0f - slimterry, 19 hours ago : 新增文件
3b4a7a8 - slimterry, 19 hours ago : 新增 new file:   CONTRIBUTING.m
351876e - slimterry, 19 hours ago : initial project version

git log --pretty=format的常用选项如下：

选项	说明
`%H`	提交对象（commit）的完整哈希字串
`%h`	提交对象的简短哈希字串
`%T`	树对象（tree）的完整哈希字串
`%t`	树对象的简短哈希字串
`%P`	父对象（parent）的完整哈希字串
`%p`	父对象的简短哈希字串
`%an`	作者（author）的名字
`%ae`	作者的电子邮件地址
`%ad`	作者修订日期（可以用 --date= 选项定制格式）
`%ar`	作者修订日期，按多久以前的方式显示
`%cn`	提交者（committer）的名字
`%ce`	提交者的电子邮件地址
`%cd`	提交日期
`%cr`	提交日期，按多久以前的方式显示
`%s`	提交说明

图像化输出提交记录（–graph）

当 oneline 或 format 与另一个 log 选项 --graph 结合使用时尤其有用。这个选项添加了一些ASCII字符串来形象地展示你的分支、合并历史，比如：

$ git log --pretty=format:"%h %s" --graph
* 2d3acf9 ignore errors from SIGCHLD on trap
*  5e3ee11 Merge branch 'master' of git://github.com/dustin/grit
|\
| * 420eac9 Added a method for getting the current branch.
* | 30e367c timeout code and tests
* | 5a09431 add timeout protection to grit
* | e1193f8 support for heads with slashes in them
|/
* d6016bc require time for xmlschema
*  11d191e Merge branch 'defunkt' into local

git log常用选项

选项	说明
`-p`	按补丁格式显示每个更新之间的差异。
`--stat`	显示每次更新的文件修改统计信息。
`--shortstat`	只显示 --stat 中最后的行数修改添加移除统计。
`--name-only`	仅在提交信息后显示已修改的文件清单。
`--name-status`	显示新增、修改、删除的文件清单。
`--abbrev-commit`	仅显示 SHA-1 的前几个字符，而非所有的 40 个字符。
`--relative-date`	使用较短的相对时间显示（比如，“2 weeks ago”）。
`--graph`	显示 ASCII 图形表示的分支合并历史。
`--pretty`	使用其他格式显示历史提交信息。可用的选项包括 oneline，short，full，fuller 和 format（后跟指定格式）。

限制(筛选)git log输出

除了定制输出格式的选项之外，git log 还有许多非常实用的限制输出长度的选项，也就是只输出部分提交信息。之前你已经看到过 -2 了，它只显示最近的两条提交，实际上，这是 -<n> 选项的写法，其中的 n 可以是任何整数，表示仅显示最近的若干条提交。

另外还有按照时间作限制的选项，比如 --since 和 --until 也很有用。例如，下面的命令列出所有最近两周内的提交：

1	git log --since=2.weeks

这个命令可以在多种格式下工作，比如说具体的某一天 "2024-03-20":

1	git log --since="2024-03-20"

还有筛选作者的选项--author:

$ git log --author='slim'
commit 32b941f804b460b97ba5bc8fc87db57fda654018 (HEAD -> master)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 10:59:17 2024 +0800

    重命名Readme.md

注意：此处的-author选项是模糊匹配

还有筛选**提交说明(即：commit message)**关键字的选项--grep:

$ git log --grep '重命名'
commit 32b941f804b460b97ba5bc8fc87db57fda654018 (HEAD -> master)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 10:59:17 2024 +0800

    重命名Readme.md

类似地，--grep也是模糊匹配

“请注意，如果要得到同时满足这两个选项搜索条件的提交，就必须用 --all-match 选项。否则，满足任意一个条件的提交都会被匹配出来” — https://www.progit.cn/#_git_basics_chapter

上述关于--all-match选项的说明似乎有问题，测试发现即使不添加 --all-match 选项，也可能实现同时筛选多个条件的目的，比如：

$ git log --oneline --author='slim' # 所有提交记录的作者均为slimterry
32b941f (HEAD -> master) 重命名Readme.md
8baa801 删除fetch.js
9990b44 删除robot.txt
de8fb67 添加robot.txt
2ae831b 直接使用-am参数提交
6b40dfc 提交CONTRIBUTING.md
15ba6d0 修改md
2e623a6 提交.gitignore
f496a0f 新增文件
3b4a7a8 新增 new file:   CONTRIBUTING.m
351876e initial project version

$ git log --oneline --author='slim' --grep='robot' # 同时筛选2个条件（不添加all-match）
9990b44 删除robot.txt
de8fb67 添加robot.txt

$ git log --oneline --author='slim' --grep='robot' --all-match # 添加all-match）
9990b44 删除robot.txt
de8fb67 添加robot.txt

另一个非常有用的筛选选项是 -S，可以列出那些添加或移除了某些字符串的提交,比如某一次提交中，修改改了文件README.md:

$ git status
On branch master
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        modified:   README.md  # 修改了README.md

$ git diff --staged
diff --git a/README.md b/README.md
index f9ec15a..0ef4f23 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,4 @@
 My Project
 2342
 1234
+aaaa  # 此次新增的内容为 'aaaa'

$ git commit -m '修改readme' # 提交本次修改
[master d83bcb9] 修改readme
 1 file changed, 1 insertion(+)

此时可以通过-S选项来筛选该次提交：

$ git log -Saaaa
commit d83bcb9d965a12f5cfe05d5eb45591580d0489e4 (HEAD -> master)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 14:18:08 2024 +0800

    修改readme

注意：此处的-S也是模糊匹配，通过git log -Saa也能找到上述的记录。

撤销操作

重新提交（–amend）

有时候我们提交完了才发现漏掉了几个文件没有添加，或者提交信息写错了。此时，可以运行带有 --amend 选项的提交命令尝试重新提交：

1	$ git commit --amend -m "新的提交信息"

这个命令会将暂存区中的文件提交。

如果自上次提交以来你还未做任何修改（例如，在上次提交后马上执行了此命令），那么快照会保持不变，而你所修改的只是提交信息，比如：

$ git status  
On branch master
nothing to commit, working tree clean  # 已无任何需要提交的改动

$ git log -1  
commit d83bcb9d965a12f5cfe05d5eb45591580d0489e4 (HEAD -> master)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 14:18:08 2024 +0800

    修改readme  # 上一次提交的commit message

$ git commit -m "修改readme ---补充提交信息" --amend  # 不做任何修改，仅修改提交信息
[master f1a3002] 修改readme ---补充提交信息
 Date: Thu Mar 21 14:18:08 2024 +0800
 1 file changed, 1 insertion(+)

$ git log -2  # 查看最近的2条提交记录
commit f1a30024cee279c169888a51a1fc214bb36c561a (HEAD -> master)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 14:18:08 2024 +0800

    修改readme ---补充提交信息  # 并没有生成信息提交记录

commit 32b941f804b460b97ba5bc8fc87db57fda654018
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 10:59:17 2024 +0800

    重命名Readme.md

文本编辑器启动后，可以看到之前的提交信息。编辑后保存会覆盖原来的提交信息。

使用--amend参数并没有生成新的提交记录，而是直接覆盖了原先的提交记录(commit的hash发生了变化)

例如，你提交后发现忘记了暂存某些需要的修改，假如我们的本意是同时添加A.java和B.java这2个文件，

但是由于疏忽，仅提交了A.java这个文件：

$ git status
On branch master
Untracked files:
  (use "git add <file>..." to include in what will be committed)
        A.java
        B.java

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

$ git add A.java 

$ git commit -m '新增A.java'  # 仅提交了A.java文件
[master b8bd35c] 新增A.java
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 A.java

$ git status
On branch master
Untracked files:
  (use "git add <file>..." to include in what will be committed)
        B.java # 此时的B.java仍然是未追踪的状态

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

$ git log -2
commit b8bd35cd8c5d3fcb55a84dc4b68289c888e886ec (HEAD -> master)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 14:42:40 2024 +0800

    新增A.java

commit f1a30024cee279c169888a51a1fc214bb36c561a
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 14:18:08 2024 +0800

    修改readme ---补充提交信息

可以像下面这样操作：

$ git add B.java # 新增遗漏的文件

$ git commit -m '新增A.java和B.java' --amend # 通过amend参数提交
[master a824b78] 新增A.java和B.java
 Date: Thu Mar 21 14:42:40 2024 +0800
 2 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 A.java
 create mode 100644 B.java

$ git log -2
commit a824b78efb10b0148ad23d6d730797697422df84 (HEAD -> master)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 14:42:40 2024 +0800

    新增A.java和B.java # 最终只有一次提交记录（覆盖）

commit f1a30024cee279c169888a51a1fc214bb36c561a
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 14:18:08 2024 +0800

    修改readme ---补充提交信息

最终你只会有一个提交 - 第二次提交将覆盖第一次提交的结果。

取消暂存的文件

假设你已经修改了两个文件A.java和B.java并且想要将它们作为两次独立的修改提交，但是却意外地输入了 git add * 暂存了它们两个
:

$ git status
On branch master
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   A.java
        modified:   B.java

no changes added to commit (use "git add" and/or "git commit -a"

$ git add * # 意外直接提交了所有改动
git status
On branch master
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        modified:   A.java
        modified:   B.java

如何只取消暂存两个中的一个呢？ git status 命令提示了你use "git restore --staged <file>..." to unstage：

1	$ git restore --staged B.java # 将B.java从暂存中移除

此时再次查看仓库的状态：

$ git status
On branch master
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        modified:   A.java

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   B.java # B.java已经变为未暂存的状态

撤消对文件的修改

如果你并不想保留对 B.java 文件的修改怎么办？你该如何方便地撤消修改 - 将它还原成上次提交时的样子（或者刚克隆完的样子，或者刚把它放入工作目录时的样子）？

git status的结果中给出了方法use "git restore <file>..." to discard changes in working directory

$ git status
On branch master
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        modified:   A.java

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   B.java
        
$ git restore B.java # 撤消对文件的修改

注意

此处的git restore撤销的是针对未暂存文件的修改

远程仓库的使用

查看远程仓库

如果想查看你已经配置的远程仓库服务器，可以运行 git remote 命令。它会列出你指定的每一个远程服务器的简写。如果你已经克隆了自己的仓库，那么至少应该能看到 origin - 这是 Git 给你克隆的仓库服务器的默认名字：

$ git remote -v
gitee   https://gitee.com/terrylikescoding/terrylikescoding.git (fetch)
gitee   https://gitee.com/terrylikescoding/terrylikescoding.git (push)
gitlab  https://gitlab.com/terrylikescoding/terrylikescoding.gitlab.io.git (fetch)
gitlab  https://gitlab.com/terrylikescoding/terrylikescoding.gitlab.io.git (push)
origin  git@github.com:terrylikescoding/hexo-deployer.git (fetch)
origin  git@github.com:terrylikescoding/hexo-deployer.git (push)

选项 -v，会显示需要读写远程仓库使用的 Git 保存的简写与其对应的 URL

若不使用-v,则输出如下：
1
2
3
4
$ git remote
gitee
gitlab
origin

添加远程仓库

通过如下命令：

1	git remote add <shortname> <url>

比如：

$ git remote
origin # 原先只有一个远程仓库

$ git remote add pb https://github.com/paulboone/ticgit # 关联新的远程仓库

$ git remote -v
origin	https://github.com/schacon/ticgit (fetch)
origin	https://github.com/schacon/ticgit (push)
pb	https://github.com/paulboone/ticgit (fetch) # pb
pb	https://github.com/paulboone/ticgit (push)

现在你可以在命令行中使用字符串 pb 来代替整个 URL。例如，如果你想拉取 Paul 的仓库中有但你没有的信息，可以运行 git fetch pb：

$ git fetch pb
remote: Counting objects: 43, done.
remote: Compressing objects: 100% (36/36), done.
remote: Total 43 (delta 10), reused 31 (delta 5)
Unpacking objects: 100% (43/43), done.
From https://github.com/paulboone/ticgit
 * [new branch]      master     -> pb/master
 * [new branch]      ticgit     -> pb/ticgit

从远程仓库中抓取与拉取

从远程仓库中获得数据，可以执行：

1	git fetch [remote-name]

这个命令会访问远程仓库，从中拉取所有你还没有的数据。执行完成后，你将会拥有那个远程仓库中所有分支的引用，可以随时合并或查看。

如果你使用 clone 命令克隆了一个仓库，命令会自动将其添加为远程仓库并默认以 origin”为简写。所以，git fetch origin 会抓取克隆（或上一次抓取）后新推送的所有工作。必须注意 git fetch 命令会将数据拉取到你的本地仓库 - 但是它并不会自动合并或修改你当前的工作。当准备好时你必须手动将其合并入你的工作。

使用

git pull

命令来自动的抓取然后合并远程分支到当前分支,如果有冲突需要手动解决。默认情况下，git clone 命令会自动设置本地 master 分支跟踪克隆的远程仓库的 master 分支（或不管是什么名字的默认分支，有可能是main）。运行 git pull 通常会从最初克隆的服务器上抓取数据并自动尝试合并到当前所在的分支。

推送到远程仓库

当你想分享你的项目时，必须将其推送到上游。这个命令很简单：

1	git push [remote-name] [branch-name]

当你想要将 master 分支推送到 origin 服务器时，那么运行这个命令就可以将你所做的备份到服务器：

1	$ git push origin master

只有当你有所克隆服务器的写入权限，并且之前没有人推送过时，这条命令才能生效。当你和其他人在同一时间克隆，他们先推送到上游然后你再推送到上游，你的推送就会毫无疑问地被拒绝。 你必须先将他们的工作拉取下来并将其合并进你的工作后才能推送。

查看远程仓库

如果想要查看某一个远程仓库的更多信息，可以使用 git remote show [remote-name] 命令。如果想以一个特定的缩写名运行这个命令，例如 origin，会得到像下面类似的信息：

$ git remote show origin
* remote origin
  Fetch URL: git@github.com:terrylikescoding/hexo-deployer.git
  Push  URL: git@github.com:terrylikescoding/hexo-deployer.git
  HEAD branch: master
  Remote branch:
    master tracked
  Local branch configured for 'git pull':
    master merges with remote master
  Local ref configured for 'git push':
    master pushes to master (fast-forwardable)

远程仓库的移除和重命令

如果想要重命名引用的名字可以运行 git remote rename 去修改一个远程仓库的简写名。例如，想要将 pb 重命名为 paul，可以用 git remote rename 这样做：

$ git remote rename pb paul
$ git remote
origin
paul # 已经被重命名为paul

值得注意的是这同样也会修改你的远程分支名字。那些过去引用 pb/master 的现在会引用 paul/master。

如果因为一些原因想要移除一个远程仓库 - 你已经从服务器上搬走了或不再想使用某一个特定的镜像了，又或者某一个贡献者不再贡献了 - 可以使用 git remote rm ：

1
2
3

$ git remote rm paul
$ git remote
origin

-l or --list

List tags. With optional <pattern>..., e.g. git tag --list 'v-*', list only the tags that match the pattern(s).

Running “git tag” without arguments also lists all tags. The pattern is a shell wildcard (i.e., matched using fnmatch(3)). Multiple patterns may be given; if any of them matches, the tag is shown.

比如：

1 2	$ git tag -l '*preview' v1.1-preview

注意：通过git tag -l 'preview'并不能匹配到上面的记录v1.1-preview

创建标签

Git 使用两种主要类型的标签：轻量标签（lightweight）与附注标签（annotated）。

一个轻量标签很像一个不会改变的分支 - 它只是一个特定提交的引用。

然而，附注标签是存储在 Git 数据库中的一个完整对象。它们是可以被校验的；其中包含

打标签者的名字、电子邮件地址、日期时间；
还有一个标签信息；并且可以使用 GNU Privacy Guard （GPG）签名与验证。 通常建议创建附注标签，这样你可以拥有以上所有信息；但是如果你只是想用一个临时的标签，或者因为某些原因不想要保存那些信息，轻量标签也是可用的。

附注标签

在 Git 中创建一个附注标签是很简单的。最简单的方式是当你在运行 tag 命令时指定 -a 选项：

-a or --annotate : Make an unsigned, annotated tag object

-m <msg> or --message=<msg>:Use the given tag message (instead of prompting). If multiple -m options are given, their values are concatenated as separate paragraphs. Implies -a if none of -a, -s, or -u <key-id> is given.

比如：

1
2
3

$ git tag -a v1.0 -m '初始版本v1.0'
$ git tag
v1.0

注意：

对于同一个版本，可以添加多个标签。

轻量标签

另一种给提交打标签的方式是使用轻量标签。轻量标签本质上是将提交校验和存储到一个文件中 - 没有保存任何其他信息。创建轻量标签，不需要使用 -a、-s 或 -m 选项，只需要提供标签名字：

$ git tag v1.1-preview
$ git tag
v1.0  # 附注标签
v1.1-preview # 轻量标签

查看标签详细信息

通过使用 git show 命令可以看到标签信息，对于上述创建标签章节中创建的附注标签，其显示结果如下：

$ git show v1.0
tag v1.0
Tagger: slimterry <slimterry@qq.com>
Date:   Fri Mar 22 10:22:25 2024 +0800

初始版本v1.0 # 创建标签时的message

commit a824b78efb10b0148ad23d6d730797697422df84 (HEAD -> master, tag: v1.1-preview, tag: v1.1, tag: v1.0)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 14:42:40 2024 +0800

    新增A.java和B.java

diff --git a/A.java b/A.java
new file mode 100644
index 0000000..e69de29
diff --git a/B.java b/B.java
new file mode 100644
index 0000000..e69de29

对于创建标签章节中创建的轻量标签，其结果显示如下：

$ git show v1.1-preview
commit a824b78efb10b0148ad23d6d730797697422df84 (HEAD -> master, tag: v1.1-preview, tag: v1.1, tag: v1.0)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 14:42:40 2024 +0800

    新增A.java和B.java

diff --git a/A.java b/A.java
new file mode 100644
index 0000000..e69de29
diff --git a/B.java b/B.java
new file mode 100644
index 0000000..e69de29

附注标签比轻量标签多了如下的信息：

Tagger: slimterry <slimterry@qq.com>
Date:   Fri Mar 22 10:22:25 2024 +0800

初始版本v1.0 # 创建标签时的message

即多显示了打标签者的信息、打标签的日期时间、附注信息。

注意：git show是一个多功能命令，可以用来查看git中多种对象的信息，其在git官方文档中的描述如下：

1	git show [<options>] [<object>…]

Shows one or more objects (blobs, trees, tags and commits).

For commits it shows the log message and textual diff. It also presents the merge commit in a special format as produced by git diff-tree --cc.

For tags, it shows the tag message and the referenced objects.

For trees, it shows the names (equivalent to git ls-tree with --name-only).

For plain blobs, it shows the plain contents.

Some options that git log command understands can be used to control how the changes the commit introduces are shown.

删除标签

通过git tag -d可以删除标签：

$ git tag
v1.0
v1.1
v1.1-preview

$ git tag -d v1.1
Deleted tag 'v1.1' (was c7e2557)

为过去的某个版本打标签

上述的创建的标签都是在当前的版本创建的，如果希望给过去的某个版本打标签，这么操作：

首先找到需要补充tag的版本：

$ git log --oneline
a824b78 (HEAD -> master, tag: v1.1-preview, tag: v1.0) 新增A.java和B.java
f1a3002 修改readme ---补充提交信息
32b941f 重命名Readme.md
8baa801 删除fetch.js
9990b44 删除robot.txt
de8fb67 添加robot.txt

通过为git tag添加commit id 即可实现：

$ git tag -a v0.6 -m '版本v0.6,删除fetch.js' 8baa801

$ git tag
v0.6     # 补充的tag
v1.0
v1.1-preview

推送标签到远端

默认情况下，git push 命令并不会传送标签到远程仓库服务器上。在创建完标签后你必须显式地推送标签到共享服务器上。这个过程就像共享远程分支一样，你可以运行 git push origin [tagname]。

比如：

$ git push origin v1.5 # v1.5 为tag名称
Counting objects: 14, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (12/12), done.
Writing objects: 100% (14/14), 2.05 KiB | 0 bytes/s, done.
Total 14 (delta 3), reused 0 (delta 0)
To git@github.com:schacon/simplegit.git
 * [new tag]         v1.5 -> v1.5

如果想要一次性推送很多标签，也可以使用带有 --tags 选项的 git push 命令。这将会把所有不在远程仓库服务器上的标签全部传送到那里。

$ git push origin --tags
Counting objects: 1, done.
Writing objects: 100% (1/1), 160 bytes | 0 bytes/s, done.
Total 1 (delta 0), reused 0 (delta 0)
To git@github.com:schacon/simplegit.git
 * [new tag]         v1.4 -> v1.4
 * [new tag]

现在，当其他人从仓库中克隆或拉取，他们也能得到你的那些标签。

检出远端的标签

检出标签

在 Git 中你并不能真的检出一个标签，因为它们并不能像分支一样来回移动。如果你想要工作目录与仓库中特定的标签版本完全一样，可以使用 git checkout -b [branchname] [tagname] 在特定的标签上创建一个新分支：

1 2	$ git checkout -b bugfix v2.0.0 Switched to a new branch 'bugfix'

为git命令设置别名

如果不想每次都输入完整的 Git 命令，可以通过 git config 文件来轻松地为每一个命令设置一个别名。比如：

$ git config --global alias.co checkout
$ git config --global alias.br branch
$ git config --global alias.ci commit
$ git config --global alias.st status

此时我们可以直接使用别名，比如：

1
2
3

$ git st # 相当于git status
On branch master
nothing to commit, working tree clean

也可以为一些繁琐的命令传递参数，比如添加一个last来方便查看最后一次提交：

1	git config --global alias.last 'log -1 HEAD'

这样，可以轻松地看到最后一次提交：

$ git last
commit a824b78efb10b0148ad23d6d730797697422df84 (HEAD -> master, tag: v1.1-preview, tag: v1.0)
Author: slimterry <slimterry@qq.com>
Date:   Thu Mar 21 14:42:40 2024 +0800

    新增A.java和B.java

可以看出，Git 只是简单地将别名替换为对应的命令。然而，你可能想要执行外部命令，而不是一个 Git 子命令。如果是那样的话，可以在命令前面加入 ! 符号。如果你自己要写一些与 Git 仓库协作的工具的话，那会很有用。我们现在演示将 git visual 定义为 gitk 的别名：

1	$ git config --global alias.visual '!gitk'

设置完成后，就可以通过如下命令调用gitk

1	git visual

仓库状态查看

git status命令

git status -s说明

提交文件

跳过git add

删除文件

方法1 先删除，然后使用git rm记录

方法2 使用git rm（暂存区中没有改动）

方法3 使用git rm -f(暂存区中有改动)

差异对比

查看尚未暂存部分的差异

查看已暂存部分的差异

–staged 和 --cached

移动（重命名）文件

查看提交历史

基础用法

显示每次提交的内容差异(-p选项)

查看每次提交的简略信息（–stat）

美化输出(–pretty)

图像化输出提交记录（–graph）

git log常用选项

限制(筛选)git log输出

撤销操作

重新提交（–amend）

取消暂存的文件

撤消对文件的修改

远程仓库的使用

查看远程仓库

添加远程仓库

从远程仓库中抓取与拉取

推送到远程仓库

查看远程仓库

远程仓库的移除和重命令

标签

列出标签

创建标签

附注标签

轻量标签

查看标签详细信息

删除标签

为过去的某个版本打标签

推送标签到远端

检出远端的标签

检出标签

为git命令设置别名