在Ubuntu服务器搭建Git仓库，以及Git使用基本流程

一、在Ubuntu服务器中创建新用户，专用于搭建Git仓库二、Ubuntu客户端Git安装、配置三、vscode使用git协作四、Git Graph插件五、总结

本文介绍了如何在Ubuntu服务器搭建简易的Git仓库，适用于小型团队的代码寄存，管理以及版本控制，介绍了在vscode中使用集成Git工具以及Git Graph插件。

一、在Ubuntu服务器中创建新用户，专用于搭建Git仓库

登录任何能连接上局域网的Ubuntu服务器，最好是24小时开机运行，比如我的服务器ip为<code>192.168.5.5

(base) PS C:\Users\29116\Desktop> ssh jetson@192.168.5.5

Welcome to Ubuntu 18.04.6 LTS (GNU/Linux 4.9.337-tegra aarch64)

* Documentation: https://help.ubuntu.com

* Management: https://landscape.canonical.com

* Support: https://ubuntu.com/pro

This system has been minimized by removing packages and content that are

not required on a system that users do not log into.

To restore this content, you can run the 'unminimize' command.

Expanded Security Maintenance for Infrastructure is not enabled.

1 update can be applied immediately.

1 of these updates is a standard security update.

To see these additional updates run: apt list --upgradable

176 additional security updates can be applied with ESM Infra.

Learn more about enabling ESM Infra service for Ubuntu 18.04 at

https://ubuntu.com/18-04

Last login: Sat May 11 15:08:30 2024 from 192.168.5.20

jetson@jetson-desktop:~$

添加新的用户，sudo adduser git，输入用户密码，再次输入，然后一直回车

jetson@jetson-desktop:~$ sudo adduser git

Adding user `git' ...

Adding new group `git' (1001) ...

Adding new user `git' (1001) with group `git' ...

Creating home directory `/home/git' ...

Copying files from `/etc/skel' ...

Enter new UNIX password:

Retype new UNIX password:

passwd: password updated successfully

Changing the user information for git

Enter the new value, or press ENTER for the default

Full Name []:

Room Number []:

Work Phone []:

Home Phone []:

Other []:

Is the information correct? [Y/n]

Adding new user `git' to extra groups ...

Adding user `git' to group `audio' ...

Adding user `git' to group `gdm' ...

Adding user `git' to group `gpio' ...

Adding user `git' to group `i2c' ...

Adding user `git' to group `lightdm' ...

Adding user `git' to group `video' ...

Adding user `git' to group `weston-launch' ...

添加用户到sudo组sudo adduser git sudo，否则使用不了sudo命令

jetson@jetson-desktop:~$ sudo adduser git sudo

Adding user `git' to group `sudo' ...

Adding user git to group sudo

Done.

检查是否添加成功，home目录新增git即为成功

jetson@jetson-desktop:~$ ls /home

git jetson

安装git，openssh-server，openssh-client

sudo apt update

sudo apt install git openssh-server openssh-client

验证

git --version

sudo systemctl status ssh

sudo systemctl enable ssh

以git账户远程登陆服务器

ssh git@192.168.5.5

创建ssh密钥对

cd ~

ssh-keygen -t rsa # 之后一直回车

在客户端也按同样的指令生成密钥对

<code>cd ~

ssh-keygen -t rsa

cd .ssh

cat id_rsa.pub# 复制这个公钥，之后要用到

将客户端公钥复制到服务器~/.ssh/authorized_keys里面

git@jetson-desktop:~$ cd .ssh

git@jetson-desktop:~/.ssh$ ls

id_rsa id_rsa.pub

git@jetson-desktop:~/.ssh$ touch authorized_keys

git@jetson-desktop:~/.ssh$ chmod 600 authorized_keys

git@jetson-desktop:~/.ssh$ echo > "替换为客户端的公钥" authorized_keys

git@jetson-desktop:~/.ssh$ sudo vim /etc/ssh/sshd_config

将#PubkeyAuthentication yes

#AuthorizedKeysFile .ssh/authorized_keys .ssh/authorized_keys2 的 #号都去掉，Esc，:+wq保存

在合适的位置创建仓库，只要有个目录就行，记住路径，之后客户端克隆要用

cd ~

mkdir ADAS.git

cd ADAS.git

初始化仓库，--bare代表仓库是裸的，方便之后上传文件

git init --bare

查看目录下的文件

git@jetson-desktop:~$ ls ~/ADAS.git/

branches config description HEAD hooks info objects refs

这个目录是一个 Git 仓库的裸版本（bare repository），通常用于作为远程仓库或共享仓库，不包含工作目录，只包含 Git 版本库的核心内容。

以下是这些目录和文件的简要说明：

branches/: 存放分支的目录，每个分支对应一个文件。

config: Git 仓库的配置文件，包含仓库的配置信息。

description: 仓库的描述文件，通常为空文件。

HEAD: 指示当前所在分支或提交的文件。

hooks/: 存放 Git 钩子脚本的目录，可以在特定事件触发时执行自定义操作。

info/: 存放仓库的一些额外信息和配置文件。

objects/: 存放 Git 版本库中所有的对象（commits、trees、blobs）。

refs/: 存放分支和标签的引用（references）。

这个目录结构是一个典型的 Git 裸仓库的组成部分。裸仓库通常用于远程仓库，供多个开发者协作使用，或者用作备份和共享中心。

二、Ubuntu客户端Git安装、配置

安装git

sudo apt update

sudo apt install git

验证是否安装成功

git --version

配置user.name和user.email，可以不填真实姓名和邮箱

git config --global user.name "Your Name"

git config --global user.email "your.email@example.com"

比如：

git config --global user.name "xiaolan"

git config --global user.email "xiaolan@qq.com"

克隆远程仓库，第一次会提示克隆了空的仓库

git clone git@192.168.5.5:~/ADAS.git

添加代码库第一个文件，新建README.md

cd ADAS

touch README.md

echo "hello git!" > README.md

写好代码后需要提交，下面介绍git提交代码的流程：

查看工作目录状态，这里显示未跟踪，因为还没有暂存

<code>xiaolan@ubuntu:~/Documents/ADAS$ git status

On branch master

Initial commit

Untracked files:

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

README.md

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

添加到暂存区，这时候显示new file了

xiaolan@ubuntu:~/Documents/ADAS$ git add README.md

xiaolan@ubuntu:~/Documents/ADAS$ git status

On branch master

Initial commit

Changes to be committed:

(use "git rm --cached <file>..." to unstage)

new file: README.md

提交到版本库

xiaolan@ubuntu:~/Documents/ADAS$ git commit -m "新增了README.md，走出了坚实的一大步"

[master (root-commit) ce4ec07] 新增了README.md，走出了坚实的一大步

1 file changed, 1 insertion(+)

create mode 100644 README.md

xiaolan@ubuntu:~/Documents/ADAS$ git status

On branch master

Your branch is based on 'origin/master', but the upstream is gone.

(use "git branch --unset-upstream" to fixup)

nothing to commit, working directory clean

这里有一个报错（你们不一定有）：提示 Your branch is based on ‘origin/master’, but the upstream is gone.，意思是你当前的分支与远程仓库的 origin/master 分支关联已经丢失。

使用以下命令来清除分支的上游关联：

git branch --unset-upstream

将本地的 master 分支与远程仓库重新关联起来，可以使用：

git push --set-upstream origin master

解决报错

xiaolan@ubuntu:~/Documents/ADAS$ git branch --unset-upstream

xiaolan@ubuntu:~/Documents/ADAS$ git push --set-upstream origin master

git@192.168.5.5's password:

Counting objects: 3, done.

Writing objects: 100% (3/3), 261 bytes | 0 bytes/s, done.

Total 3 (delta 0), reused 0 (delta 0)

To git@192.168.5.5:~/ADAS.git

* [new branch] master -> master

Branch master set up to track remote branch master from origin.

查看提交历史记录

xiaolan@ubuntu:~/Documents/ADAS$ git log

commit ce4ec0785102d1dd9dbb48c2678d67e8b3dd41c2

Author: xiaolan <xiaolan@qq.com>

Date: Sat May 11 16:37:51 2024 +0800

新增了README.md，走出了坚实的一大步

推送到远程仓库（可选）

xiaolan@ubuntu:~/Documents/ADAS$ git push origin master

git@192.168.5.5's password:

Everything up-to-date

这里出现了branch，即分支，观察 git 官方logo，也有个分支的形状，branch是 git 能够多人协作的基本机制。

就像多元宇宙的世界线一样，在你新建分支的时候，你便拥有了自己的世界线。

你可以选择自己的工作内容编写，然后暂存，提交到版本库，等到需要整合大家的工作代码时，便发生合并，统一为一个版本。

当然这里面会出现许多冲突，比如多个人修改了同一段代码，但是合并的分支只需要一个版本，这时候就需要审核员判断并手动解决。所以在工作之前先把当前最新的工作代码拉取到本地对照，保持本地与远程仓库的同步，将是个好习惯。

查看当前分支

<code>xiaolan@ubuntu:~/Documents/ADAS$ git branch

* master

新建分支并切换到该分支

xiaolan@ubuntu:~/Documents/ADAS$ git checkout -b xiaolan

Switched to a new branch 'xiaolan'

xiaolan@ubuntu:~/Documents/ADAS$ git branch #你会看到带有 * 符号的分支名称是新创建的 xiaolan

master

* xiaolan

现在你可以在新分支 xiaolan 上进行代码修改、提交等操作。切换回主分支（可选）

xiaolan@ubuntu:~/Documents/ADAS$ git checkout master

Switched to branch 'master'

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

xiaolan@ubuntu:~/Documents/ADAS$ git branch

* master

xiaolan

使用xiaolan分支，修改，暂存，提交，推送代码

xiaolan@ubuntu:~/Documents/ADAS$ git checkout xiaolan

Switched to branch 'xiaolan'

xiaolan@ubuntu:~/Documents/ADAS$ echo "hello, i am xiaolan!" > README.md

xiaolan@ubuntu:~/Documents/ADAS$ git add README.md

xiaolan@ubuntu:~/Documents/ADAS$ git commit -m "README.md modified by xiaolan"

[xiaolan 8277300] README.md modified by xiaolan

1 file changed, 1 insertion(+), 1 deletion(-)

xiaolan@ubuntu:~/Documents/ADAS$ git push origin xiaolan

git@192.168.5.5's password:

Counting objects: 3, done.

Writing objects: 100% (3/3), 270 bytes | 0 bytes/s, done.

Total 3 (delta 0), reused 0 (delta 0)

To git@192.168.5.5:~/ADAS.git

* [new branch] xiaolan -> xiaolan

查看提交历史记录

xiaolan@ubuntu:~/Documents/ADAS$ git log

commit 827730004dfd675af9391fa191272ad6c08309b4

Author: xiaolan <xiaolan@qq.com>

Date: Sat May 11 17:16:29 2024 +0800

README.md modified by xiaolan

commit ce4ec0785102d1dd9dbb48c2678d67e8b3dd41c2

Author: xiaolan <xiaolan@qq.com>

Date: Sat May 11 16:37:51 2024 +0800

新增了README.md，走出了坚实的一大步

合并分支，为了效果更明显，我们先进入master分支，改变README.md的第一行和第三行内容，来人为制造冲突

xiaolan@ubuntu:~/Documents/ADAS$ git checkout master

Switched to branch 'master'

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

xiaolan@ubuntu:~/Documents/ADAS$ vim README.md

xiaolan@ubuntu:~/Documents/ADAS$ cat README.md

hello git! <conflict1>

<conflict2>

xiaolan@ubuntu:~/Documents/ADAS$ git add README.md

xiaolan@ubuntu:~/Documents/ADAS$ git commit -m "新增了conflict"

[master dfd6f91] 新增了conflict

1 file changed, 3 insertions(+), 1 deletion(-)

xiaolan@ubuntu:~/Documents/ADAS$ git push origin master

git@192.168.5.5's password:

Counting objects: 3, done.

Writing objects: 100% (3/3), 281 bytes | 0 bytes/s, done.

Total 3 (delta 0), reused 0 (delta 0)

To git@192.168.5.5:~/ADAS.git

ce4ec07..dfd6f91 master -> master

xiaolan@ubuntu:~/Documents/ADAS$

合并分支的步骤

合并xiaolan分支到master分支需要切换到master分支

<code>xiaolan@ubuntu:~/Documents/ADAS$ git branch

* master

xiaolan

使用git merge命令合并

xiaolan@ubuntu:~/Documents/ADAS$ git merge xiaolan

Auto-merging README.md

CONFLICT (content): Merge conflict in README.md

Automatic merge failed; fix conflicts and then commit the result.

出现冲突

xiaolan@ubuntu:~/Documents/ADAS$ git status

On branch master

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

You have unmerged paths.

(fix conflicts and run "git commit")

Unmerged paths:

(use "git add <file>..." to mark resolution)

both modified: README.md

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

查看冲突

xiaolan@ubuntu:~/Documents/ADAS$ cat README.md

<<<<<<< HEAD

hello git! <conflict1>

<conflict2>

=======

hello, i am xiaolan!

>>>>>>> xiaolan

<<<<<<< HEAD 表示当前分支（通常是目标分支，如 master）的内容。

======= 是分隔符，用于分隔两个不同分支的内容。

>>>>>>> branch_name 表示要合并的分支（如 xiaolan）的内容。

手动编辑冲突文件，选择保留或修改其中的内容，以解决冲突。删除冲突标记 <<<<<<<、=======、>>>>>>> 并保留正确的代码。

xiaolan@ubuntu:~/Documents/ADAS$ vim README.md

xiaolan@ubuntu:~/Documents/ADAS$ cat README.md

hello git! <conflict1>

hello, i am xiaolan!

<conflict2>

暂存，提交，推送解决冲突后的代码

xiaolan@ubuntu:~/Documents/ADAS$ git add README.md

xiaolan@ubuntu:~/Documents/ADAS$ git commit -m "解决了conflict"

[master f06d9bb] 解决了conflict

xiaolan@ubuntu:~/Documents/ADAS$ git push origin master

git@192.168.5.5's password:

Counting objects: 3, done.

Delta compression using up to 8 threads.

Compressing objects: 100% (2/2), done.

Writing objects: 100% (3/3), 325 bytes | 0 bytes/s, done.

Total 3 (delta 0), reused 0 (delta 0)

To git@192.168.5.5:~/ADAS.git

dfd6f91..f06d9bb master -> master

xiaolan@ubuntu:~/Documents/ADAS$

到此便合并成功

三、vscode使用git协作

想必了解了这么多关于git的用法，大家还是会觉得使用命令行过于繁琐，尤其是涉及到的文件很多时，解决冲突会变成一场灾难，所以这里介绍使用vscode自带的gui来轻松完成上面复杂的工作。

vscode集成git

进入vscode，左边工具栏自带git工具，里面有很多选项，见下图：

选项栏内容

工程目录下文件改动的标记

使用vscode进行协作

创建并更改分支，创建时输入分支名，如xiaohong，等同于git checkout -b xiaohong

暂存改动后的文件，等同于<code>git add README.md

输入提交信息，等同于<code>git commit -m "修改了 README.md"

点击同步更新，等同于<code>git push origin xiaohong

拉取master版本，同步更改（推送代码前最好先拉取主分支）

合并分支，等同于’git checkout master’加’git merge xiaohong’

出现合并冲突

手动修改解决冲突

* 我这里保留双方修改

然后又是，暂存，提交，同步更改

到此，合并完成

四、Git Graph插件

点击vscode左侧插件工具栏，搜索Git Graph安装

回到git管理，多出一个Git Graph图标，点击

哇哦，多么美妙的图形，将分支非常直观地展现出来了，可以发现：

每个节点都是commit提交的记录当发布新的分支时，主分支便会分出一条支线，合并分支时，便会回到主分支

不只如此，点击各个节点还能看到详细信息

右键点击右侧的文件

<code>View Diff：查看本次commit提交的文件和提交前的文件的对比

<code>View File at this Revision：查看本次修改的文件

<code>View Diff with Working File：查看本次commit提交的文件和工作区的文件的对比

五、总结

介绍了如何在Ubuntu服务器搭建Git仓库介绍了如何使用Git命令介绍了如何使用VsCode集成的Git工具介绍了实用的Git Graph插件使用Git协作来提高效率的例子

参考资料：

基于Ubuntu环境Git服务器搭建及使用

Git 基本命令汇总

GIT常用命令大全——赶紧收藏

手把手教你在VSCode中使用Git

Git版本控制：提升开发效率的利器