Git - 初识版本库

时间:2024-09-29 18:30:21

版本库也叫仓库,英文名 repository。

创建版本库

之前我们说了版本库的概念:

存储版本的地方(存放各个版本之间差异的地方),通常称为版本库。通常版本库是以文件(夹)的形式存放在磁盘上:

  • Git 是用一个目录来存储各个版本和差异的文件,目录名字为 .git​;
  • SVN 同理,用 .svn​ 目录来存储的
  • CVS 同理,用 .csv​ 目录来存储的

一般情况下这几个目录是隐藏的(防止被随意的删除和修改等),在 Windows 上可以通过显示隐藏文件夹来查看,Linux 下可以用 ls -ah​ 命令查看

有了版本库,我们就可以跟踪里面所有的文件的改动,包括添加,修改和删除,并且可以追踪历史(什么时候被添加,修改了多少次,每次修改了什么),还可以还原到某个历史。

接下来我们来实践,也建议读者一起动手。

在 Git 中,创建一个版本库非常简单,新建一个文件夹(名字最好不要带有中文和空格),打开 cmd 或者 Git Bash,输入以下命令即可:

$ git init

或者同时创建文件夹并初始化:

$ git init demo

示例:

> mkdir LearnGit
> cd LearnGit
> git init
Initialized empty Git repository in D:/Projects/LearnGit/LearnGit/.git/

可以看到 Git 告诉我们已经创建好了版本库,并且是该仓库目前是空的(还没有管理任何文件)。

此时我们可以看到有一个.git 文件夹被创建了,这就是版本库,默认是隐藏的。

如果是 Linux 环境下,读者也可以使用 ls -ah ​命令查看当前目录下有什么文件。

特别注意:如果你使用 Windows 系统,为了避免遇到各种莫名其妙的问题,请确保目录名(包括父目录)不包含中文和空格。

也不一定必须在空目录下创建 Git 仓库,选择一个已经有东西的目录也是可以的,但推荐用空目录开始练习,避免在学习过程中对那些文件有什么影响。

添加文件到版本库

将文件用版本库管理起来只需两步:

  1. 将文件添加到版本库
  2. 提交到版本库

实践:将刚刚我们演示 diff 和 patch 命令的文件添加到版本库里。我们创建 1-diffAndPath 文件夹,然后将文件挪到该文件夹里。此时的目录结构为:

LearnGit
└── 1-diffAndPath
    ├── diff.txt
    ├── hello.txt
    └── world.txt

那么开始第一步,使用 git add 文件名 ​来告诉 Git,添加文件到版本库

git add 1-diffAndPath/hello.txt

执行上面的命令,没有任何显示,这就对了,Unix 的哲学是“没有消息就是好消息”。

如果是在 Windows 下,可能会有如下警告(warning):

warning: LF will be replaced by CRLF in 1-diffAndPath/hello.txt.
The file will have its original line endings in your working directory

这是说在版本库里,换行符会被替换为 CRLF;但我们自己的原始文件不会有影响,我们后续展开来说。如果你实在感兴趣并有一定的基础,可以参考这个回答:newline - LF will be replaced by CRLF in git - What is that and is it important? - Stack Overflow

第二步,我们就可以用 git commit ​命令,告诉 Git,将文件提交到版本库:

> git commit -m "add diff and patch hello.txt"
[master (root-commit) abf2051] add diff and patch hello.txt
 1 file changed, 2 insertions(+)
 create mode 100644 1-diffAndPath/hello.txt

我们提交后,这次 Git 有好消息显示了:

  • 1 file changed​:有一个文件被改动(添加也是一种改动)
  • 2 insertions(+)​:插入了 2 行内容(hello.txt 有 2 行)

其他消息我们暂且不表。


-m​ 参数后面是对本次提交的说明,这里我简单写了下添加一个文件。说明应该是有意义的,方便自己或其他人知道这次提交了什么内容,不建议随便输入说明,甚至不输入说明。

事实上,如果不使用-m 参数,是有报错的:Aborting commit due to empty commit message.

强烈建议使用 -m 参数,如果实在不想输入,请自行 Google,这里不演示这种不好的用法


为什么 Git 添加文件需要 add​,commit ​一共两步呢?因为 commit ​可以一次提交很多文件,所以你可以多次 add ​不同的文件,比如:

> git add 1-diffAndPath/world.txt 1-diffAndPath/diff.txt
> git commit -m "add world.txt and diff.txt"
[master 0b3cfef] add world.txt and diff.txt
 2 files changed, 11 insertions(+)
 create mode 100644 1-diffAndPath/diff.txt
 create mode 100644 1-diffAndPath/world.txt

需要注意的是,版本库里的子文件夹下,也可以执行 git add 等命令。但如果不是在版本库里执行 git add 和 git commit 等命令,是没有意义的,因为都还没创建版本库。比如我们随便在一个没有创建版本库的地方执行:

> git add .
fatal: not a git repository (or any of the parent directories): .git

这个报错(fatal)是告诉我们,目前的文件夹并没有版本库,并且其所有父目录也没有版本库。

小技巧:

如果文件比较多,一个一个添加比较麻烦,可以使用 git add . ​表示添加所有,然后再 commit;

或者直接一条命令解决:git commit -am​,注意该方式只适用于已被 git 追踪的文件(即文件至少提交过一次)。

版本库的状态:git status

我们在一个新的目录来演示。

$ mkdir 2-versionControl
$ cd 2-versionControl

我们新建一个文件,readme.txt,并准备以下内容:

$ touch readme.txt
$ echo "Git is a version control system" >> readme.txt
$ echo "Git is free software" >> readme.txt
$ cat readme.txt
Git is a version control system
Git is free software

我们介绍下 git status 命令,该命令可以让我们时刻掌握仓库当前的状态:

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

结果显示,当前目录 ./ ​没有纳入 Git 来管理跟踪(Untracked )。

我们可以用 git add ​命令来添加当前目录:

$ git add ./

然后我们再次查看仓库状态:

$ git status
On branch master
Changes to be committed:
  (use "git restore --staged <file>..." to unstage)
        new file:   readme.txt

此时 Git 告诉我们添加了一个新文件(new file: readme.txt),并且可以被提交(Changes to be committed)。

我们来提交下:

$  git commit -m "wrote a readme file"
[master 0282c44] wrote a readme file
 1 file changed, 2 insertions(+)
 create mode 100644 2-versionControl/readme.txt

然后再次查看 Git 仓库状态:

$ git status
On branch master
nothing to commit, working tree clean

此时 Git 告诉我们,目前没有什么需要被提交的,工作目录是干净的(working tree clean,其他信息我们晚点再讲)

如果我们修改文件呢?例如修改 readme.txt 文件,改成如下内容:

Git is a distributed version control system.
Git is free software.

我们来看看仓库状态:

$ vim readme.txt

$ cat readme.txt
Git is a distributed version control system
Git is free software

$ 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:   readme.txt

Git 告诉我们,readme.txt 被修改了( modified: readme.txt),但还没准备提交(Changes not staged for commit)。

比较差异:git diff

有时候,我们需要比较下当前版本和上一个版本的差异(比如你度蜜月回来,已经记不清上次改了什么),此时我们就可以用 git diff 命令了:

$ git diff readme.txt
diff --git a/2-versionControl/readme.txt b/2-versionControl/readme.txt
index f7249b8..2fdf0c4 100644
--- a/2-versionControl/readme.txt
+++ b/2-versionControl/readme.txt
@@ -1,2 +1,2 @@
-Git is a version control system
+Git is a distributed version control system
 Git is free software

可以看到,git diff 命令的输出,和我们之前讲的 diff 命令的输出很像,这里就不再一一说明了。通过输出我们可以看到,第一行被修改了,添加了一个 distributed ​单词。

此时我们可以继续提交:

$ git add readme.txt

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

$ git commit -m "add distributed word"
[master 750360e] add distributed word
 1 file changed, 1 insertion(+), 1 deletion(-)

深入 Git diff

  • git diff ​比较的是工作区和暂存区的所有差别

    • git diff -- 文件名​:查看具体某个文件 在工作区和暂存区之间的差异
    • git diff -- 文件名1 文件名2 文件名3​:查看多个文件在工作区和暂存区之间的差异
  • git diff --cached​ 比较的是暂存区和版本库的差别

  • git diff HEAD​ 可以查看工作区和版本库的差别

  • git diff --name-status​:仅查看被修改的文件名和状态。有时候我们只想知道哪些文件被修改了,不想知道修改了什么,可以使用这个命令。

我们来演示下。首先创建一个 txt,并添加和提交到版本库

$ echo "test diff" > 4-diff/testDiff.txt
$ git add .
$ git commit -m "add testDiff.txt"

我们修改下该文件:

$ echo "test diff" >> 4-diff/testDiff.txt

然后使用 git diff ​查看

$ git diff 4-diff/testDiff.txt
diff --git a/4-diff/testDiff.txt b/4-diff/testDiff.txt
index b69a2df..47bb840 100644
--- a/4-diff/testDiff.txt
+++ b/4-diff/testDiff.txt
@@ -1 +1,2 @@
 test diff
+test diff

此时我们使用 git diff HEAD​,和上面的输出一样。

此时由于我们还没添加到暂存区,使用 git diff --cached 是没有输出的。我们添加到暂存区后再次查看:

$ git diff --cached 4-diff/testDiff.txt

$ git add .


$ git diff --cached 4-diff/testDiff.txt
diff --git a/4-diff/testDiff.txt b/4-diff/testDiff.txt
index b69a2df..47bb840 100644
--- a/4-diff/testDiff.txt
+++ b/4-diff/testDiff.txt
@@ -1 +1,2 @@
 test diff
+test diff

此时再使用 git diff HEAD​,就没有输出了,说明版本一致。

我们来看看–name-status 参数:

$ echo "fuck" >> fuck
$ git add fuck
$ echo "echo" >> ./3-branch/branch.txt
$ git diff head --name-status
M       3-branch/branch.txt
A       fuck

可以看到输出了文件名,并且前面有个字母:M 指修改,A 指添加,D 指删除

查看某个文件的修改记录

使用 git blame 文件名​,可以看到某个文件的修改记录,包括修改用户,修改时间等;:

$ git blame 3-branch\branch.txt
dd140df7 (peterjxl          2023-01-14 16:27:11 +0800 1) Creating a new branch is quick and simple
8f876055 (peterjxl          2023-01-14 16:55:07 +0800 2) test no fast forward
17942124 (peterjxl          2023-01-14 20:06:01 +0800 3) test cherry-pick
00000000 (Not Committed Yet 2023-01-15 10:05:59 +0800 4) test

练习

将 readme.txt 文件修改如下,并提交:

Git is a distributed version control system.
Git is free software distributed under the GPL.

答案(仅供参考):

$ vim readme.txt

$ cat readme.txt
Git is a distributed version control system
Git is free software distributed under the GPL.

$ git add readme.txt

$ git commit -m "append GPL word"
[master efc9138] append GPL word
 1 file changed, 1 insertion(+), 1 deletion(-)

小结

本文我们介绍了以下几个概念

  • 创建版本库:git init​​
  • 将文件添加到版本库:git add​,可添加多个文件 git add 文件名1,文件名2​,添加所有文件 git add .
  • 提交: git commit -m 提交说明
  • 查看版本库的状态:git status​​
  • 比较文件的差异:git diff​​