初识版本库

# 02.初识版本库

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

# 创建版本库

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

存储版本的地方，我们称之为版本库。例如我们要在磁盘上存储东西，肯定是以文件的方式存储，例如Git是用一个目录来存储各个版本和差异的文件，目录名字为.git；SVN用.svn目录来存储的，CVS同理。一般情况下这几个目录是隐藏的（防止被随意的删除和修改等），在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/

1
2
3
4

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

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

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

‍

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

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

‍

# 添加文件到版本库

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

将文件添加到版本库
提交到版本库

‍

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

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

1
2
3
4
5

‍

那么开始第一步，使用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 (opens new window)

‍

第二步，我们就可以用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

1
2
3
4

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

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

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

‍

我们提交后，这次Git有好消息显示了：

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

其他消息我们暂且不表。

‍

为什么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

1
2
3
4
5
6

‍

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

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

1
2

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

‍

小技巧：

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

或者直接一条命令解决：git commit -am，注意该方式只适用于已被git追踪的文件（即文件至少提交过一次）

‍

# 版本库的状态：git status

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

$ mkdir 2-versionControl
$ cd 2-versionControl

1
2

‍

我们新建一个文件，readme.txt，并准备以下内容（Windows用户可以用右键-新建文本文件后，打开并输入）

$ 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

1
2
3
4
5
6

‍

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

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

1
2
3
4
5

结果显示，当前目录./没有纳入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

1
2
3
4
5

此时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

1
2
3
4

‍

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

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

1
2
3

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

‍

如果我们修改文件呢？例如修改readme.txt文件，改成如下内容：

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

1
2

‍

我们来看看仓库状态：

$ 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

1
2
3
4
5
6
7
8
9
10
11
12

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

1
2
3
4
5
6
7
8
9

可以看到，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(-)

1
2
3
4
5
6
7
8
9
10
11

‍

# 深入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"

1
2
3

‍

我们修改下该文件：

$ 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

1
2
3
4
5
6
7
8

此时我们使用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

1
2
3
4
5
6
7
8
9
10
11
12
13

‍

此时再使用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

1
2
3
4
5
6

可以看到输出了文件名，并且前面有个字母：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

1
2
3
4
5

‍

# 练习

将readme.txt文件修改如下，并提交：

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

1
2

‍

答案（仅供参考）：

$ 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(-)

1
2
3
4
5
6
7
8
9
10
11

‍

# 小结

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

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

‍

在GitHub上编辑此页

上次更新: 2023/4/29 21:37:53

← 安装和配置版本管理→