相关文章：Linux 7
Git
Manjaro Linux
Nginx
Nginx 重定向
Vim
十分钟掌握 TMUX
源码编译安装
2023-05-25    2024-04-29    2354 字  5 分钟
Linux

不可或缺的工具！！！

本文旨在记录个人使用过程中遇到的相关 Git 命令，非教程式的，详细学习请参阅 《Pro Git》 的中文文档。

入门篇

![[assets/Pasted image 20230525223448.png]]

安装设置

去 Git 官网 下载对应版本的 Git 安装即可，此处不再赘述。

安装完成后，需要设置当前用户的名字和 Email 地址：

1
2

git config --global user.name "Your Name"
git config --global user.email "email@example.com"

你总是可以通过以下方式获取帮助：

1
2
3

git help <verb>
git <verb> -h                   # --help 最常用，如 git config --help
man git-<verb>

也许，你还想设置一下 RSA 密钥对：

ssh-keygen -t rsa -C "email@example.com"

基本操作

1
2
3
4

git init                         # 初始化仓库
# ……
git add .                        # 添加工作区所有变更到暂存区
git commit -m "some commit log." # 提交缓存区内变更到本地仓库

进阶篇

远程仓库

我们就以 站点仓库 为例。

本地仓库和远程仓库之间的传输是通过 SSH 加密的，在使用远程仓库之前，我们需要先创建 SSH Key 。

1

ssh-keygen -t rsa -C "youremail@example.com"

在用户主目录下，会生成 .ssh 目录，包含 id_rsa （私钥）和 id_rsa.pub （公钥）等文件。

……

1
2
3
4
5
6
7
8
9

# 列出远程仓库（名称及地址）
git remote -v                   # --verbose

# 添加远程仓库
git remote add <name> <url>
# 移除远程仓库
git remote remove <name>
# 重命名远程仓库分支
git remote rename <old> <new>

关于远程仓库的其他操作，会分散在后续章节中，不在此处单独列出。

分支

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# 列出分支
git branch
git branch -l                   # --list 列出本地分支
git branch -a                   # --all  列出远程、本地分支

# 创建分支
git checkout -b <branch>

# 切换分支
git checkout <branch>

# 删除分支
git branch -d <branch>          # --delete 删除合并完全的分支
git branch -D <branch>          # 强制删除分支（包含未合并完全）
# 删除远程分支
git branch -d <remote-repo> <remote-branch>    # --delete 删除远程仓库的指定分支
git push <remote-repo> :<remote-branch>        
# Or 推送一个空分支到远程分支，其实就相当于删除远程分支
git push <remote-repo> --delete <remote-brach>

# 重命名分支
git branch -m <branch>          # --move

# 合并分支
git merge <other-branch> <current-branch>

如果你得到以下错误消息，可能是因为其他人已经删除了这个分支。

1

error: unable to push to unqualified destination: remoteBranchName The destination refspec neither matches an existing ref on the remote nor begins with refs/, and we are unable to guess a prefix based on the source ref. error: failed to push some refs to 'git@repository_name'

此时，使用 git fetch -p 同步分支列表就可以了，如此，你的分支列表里就不会显示已远程被删除的分支了。

我们从一个远程仓库拉取分支，默认会在本地创建 master 分支，并关联到远程仓库的主分支。

1
2
3
4
5
6
7
8

# 拉取远程仓库并关联到自定义本地分支
git clone -b <local-branch> <remote-repo-url>

# 摘取远程仓库指定分支并关联自定义本地分支
git remote add origin <remote-repo-url>
git fetch origin <remote-branch>
git checkout -b <local-branch> origin/<remote-branch> # ！关键
git pull origin <remote-branch>

强制推送本地分支到远程仓库分支（两者分支名称不同时），如下：

1
2
3

  # git remote add origin https://github.com/loveminimal/loveminimal.github.io.git
  # git push -f origin master:main  # 本地分支 master ，远程分支 main
  git push -f origin master         # 本地分支与远程分支名称相同，皆为 master

!!永远不要试图一蹴而就，在使用的过程中慢慢补充完善即可！

git 设置本地与远程分支关联:

1
2
3
4
5

# 查看本地与远程分支关联的情况
git branch -vv

# 设置本地与远程分支关联
git branch --set-upstream-to=origin/<remote-branch> <local-branch>

标签

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

git tag # -l, --list 列出标签
git tag -l "v1.8.5*"
git tag -n # 列出标签，并显示描述信息
git ls-remote --tags origin # 查看远程所有标签

git tag v1.4-lw # 创建轻量标签
git tag -a v2.0 -m '描述信息' # 创建附注标签
git tag -a v1.2 9fceb02 # 后期对指定提交打标签

# 重命名标签
# 先替换，后删除
git tag -f <new-tag> <old-tag> 
git tag -d <old-tag>
# or
# 先删除，后新建
git tag -d <old-tag>
git tag -a <new-tag> -m 'description message...'

git tag -d v1.4-lw # 删除标签
git push origin --delete <tagname> # 删除远程标签

# 拉取远程仓库指定标签到本地，
# 并创建 master 分支跳转
git clone --branch v1.0.0 https://github.com/loveminimal/hugo-theme-virgo.git
git switch -c master

git checkout [tag] # 切换到指定标签

Git Submodule 子模块

参考 https://zhuanlan.zhihu.com/p/87053283

:: 果然，可以模块的地方，最终都会模块化。

假定我们有两个项目： project-main （主项目）和 project-sub-1 （子模块项目）。

我们可以使用 git submodule add <submodule_url> [<local_dir_name>] 命令在项目中创建一个子模块。

💡 其中， <local_dir_name> 可选。

上述命令执行之后，项目仓库会多出两个文件： .gitmodules （子模块的相关信息）和 project-sub-1 （子模块当前版本的版本号信息）。

如何获取 submodule 呢？

为了方便，我们不妨称主模块为 Main ，子模块为 Sub 。

对于主项目 Main 使用普通的 clone 操作并不会拉取到子模块 Sub 中的实际代码（它是空的）。如果希望子模块代码也获取到，可以使用以下两种方式：

  1. 在克隆 Main 的时候带上参数 --recurse-submodules ，如此会递归地将项目中所有子模块的代码拉取；或，
  2. 在 Main 中执行 git submodule init & git submodule update ，会根据主项目的配置信息，拉取更新子模块中的代码（or git submodule update --init --recursive）。

子模块内容更新了如何操作？

对于子模块 Sub 而言，它并不知道引用自己的主项目的存在，其自身是一个完整的 Git 仓库，按照正常的 Git 代码管理规范操作即可。

主模块的处理，目前就记住，操作了 Sub 后，再去操作 Main 即可。

删除子模块

使用 git submodule deinit 命令卸载一个子模块。这个命令如果添加上参数 --force ，则子模块工作区内即使有本地的修改，也会被移除。

其他

搭建 Git 服务器并启用 Hooks

许多教程使用的都是 root 账户，其实我们使用哪个账户都可以，比如，这里我们就用当前用户 jack 来搭建 git 服务。

首先，把客户机的公钥 id_rsa.pub 文件，导入到 /home/jack/.ssh/authorized_keys 文件里（若没有，新建该文件即可），一行一个。

然后，选定一个目录作为 Git 仓库，比如 ~/.repo/site.git ，在 .repo 目录下，输入：

1

git init --bare site.git

Git 就会创建一个裸仓库，它没有工作区，纯粹是为了共享。

最后，在客户机上，就可以通过 git clone 命令克隆远程仓库了，如：

1
2
3

# jack - 服务器主机用户名
# ovirgo.com - 服务器绑定的域名（可以是 IP）
git clone jack@ovirgo.com:/home/jack/.repo/site.git

什么是 Hooks 呢？

执行 cd ~/.repo/site.git/hooks && ls ，你会发现许多 hooks 文件示例，用于该仓库去响应客户机的某些指令时的一些操作，比如，我们在客户机向该仓库推送时，自动克隆部署该仓库。

在 hooks 目录下，执行以下操作：

1
2
3

# 新建 post-receive
touch post-receive
vim post-receive

编辑 post-receive 这个钩子：

1
2
3
4

#!/bin/sh
cd /home/jack
rm -rf blog
git clone .repo/site.git blog

是的，它是一个 shell 脚本，如此而已。

综上，我们完成了服务器端的 Git 搭建及自动化部署。

实例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

# === 全局化配置用户信息
git config --global user.name  "jack"
git config --global user.email "loveminimal@163.com"

# === 生成 rsa 密钥对
ssh-keygen -t rsa -C "email@example.com"
cd ~/.ssh
cat id_rsa.pub

# === 克隆远程仓库
# --- 常用 bash 别名
cd ~
git clone https://gitee.com/loveminimal/shell.git .shell
cp -r .shell/* ./
source .bash_alias

# --- 站点源码（私有仓库）
cd ~/AppData/Roaming
git clone https://gitee.com/loveminimal/site.git

# --- 递归拉取项目及其子模块
# git clone https://gitee.com/loveminimal/site.git --recurse-submodules
# --- OR
cd ~/site
# git submodule init & git submodule update
git submodule update --init --recursive
# --- 添加其它的远程仓库
cd ~/site/themes/virgo
git remote add github https://github.com/loveminimal/hugo-theme-virgo.git
cd ~/site/static/ship
git remote add github https://github.com/loveminimal/ship.git
cd ~/site/static/emojing
git remote add github https://github.com/loveminimal/emojing.git
cd ~/site/content/.obsidian/themes/Virgo
git remote add github https://github.com/loveminimal/obsidian-theme-virgo.git

# --- 配置 Vim
cd ~
git clone https://gitee.com/loveminimal/vim.git .vim
# --- OR
# scp -r aituyaa.com:/home/jack/.vim .vim

# --- 下载浏览器插件 copy-link
cd ~/local
git clone https://gitee.com/loveminimal/copy-link.git