Git 使用指南

更新于 2024-04-10 分类： Software > Git 阅读次数：本文字数： 25k 阅读时长 ≈ 1:32

Git 是一个开源的分布式版本控制软件。自诞生以来，Git 就以其开源、简单、快捷、分布式、高效等特点，应付了类似 Linux 内核源代码等各种复杂的项目开发需求。如今，Git 已经非常成熟，被广泛接受与使用，越来越多的项目都迁移到 Git 仓库中进行管理。目前常用Git服务商：GitHub & Bitbucket & GitLab & Coding 。

I. Git

Git 进行代码版本管理时，有两种操作方式：图形界面GUI和命令行Command。

命令行Command（Git Bash）：没有平台限制，Windows、Linux（Unix、Mac OS X）下都支持，通过 gid add dir/files 添加文件，没有文件数限制。官网下载
图形界面GUI（Git GUI）：方便操作，推荐GitKraken。

Git 使用四种主要的协议来传输数据：本地传输，SSH 协议，Git 协议和 HTTPS 协议。更多内容点击查看服务器上的 Git - 协议。

推荐使用SSH 协议。

https认证连接需要输入用户名密码。如果想避免交互式输入用户密码，可以将配置git remote：

1 2	git remote add origin https://用户名:密码@github.com/用户名/repository项目名.git git push -u origin master

已经配置过的可以通过修改本地项目目录下的.git/config文件里的 [remote "origin"] 项下的 url 值，也可以通过git remote set-url origin 指令进行修改：

1
2
3

git remote set-url origin  https://用户名:密码@github.com/用户名/repository项目名.git
git remote add origin  https://用户名:密码@github.com/用户名/repository项目名.git
git push -u origin master

某些情况下使用https认证进行连接时会出现403错误。

II. Git Bash

Git 命令详解
 Git 入门

最浅显易懂的Git教程面向初学者，实用性超强，掌握了这些东西，你就可以通过Git轻松地完成你的工作。

II.I. SSH 协议

参考链接：多个git账号之间的切换，Git的多账号如何处理？，gitlab/github 多账户下设置 ssh keys。

不同网站可以使用同一个邮箱，这时候不用担心密钥的问题，因为这些网站 push pull 认证的唯一性的是邮箱。使用同一个邮箱，如果你不进行配置用户名和邮箱的话，则会使用全局的用户名和邮箱。为了方便配置，用户名、姓名和邮箱都设置一致。

GitHub Pages + Hexo 搭建博客从入门到进阶

打开【设置】-->【应用】-->【可选功能】-->【已安装功能】,查看是否安装OpenSSH 服务器和 OpenSSH 客户端。以管理员模式运行命令行窗口，执行 net start sshd 命令。重新打开 cmd ，输入 ssh localhost 即可。

II.I.I. 相同邮箱账户

创建账户，设置用户名。

打开Git Bash

1	$ cd ~/.ssh //转到C:/Users/Administrator/.ssh

备份旧的数据并删除（跳过）

# Lists the files in your .ssh directory, if they exist
$ ls -al ~/.ssh
$ mkdir key_backup
$ cp id_rsa* key_backup
$ rm id_rsa*

生成新的SSH Key

1
2
3

ssh-keygen -t rsa -C "im.sai.li@outlook.com"
# 填写注册email地址，然后一直“回车”ok
# 当然如果你想选择使用密码功能，那么在提示输入密码passphrase时输入你自己的密码。

复制生成的密钥

1 2	clip < ~/.ssh/id_rsa.pub 或用文本编辑工具打开id_rsa.pub文件

登陆系统添加SSH公钥，直接粘贴到key文本框中，点击 add key。title可以随便命名，然后点击add。

配置完成之后生成一个.gitconfig配置文件。

1
2
3

$ git config --global user.name "sli1989"
$ git config --global user.email "im.sai.li@outlook.com"
$ git config --list # 查看配置

测试连接是否成功。提示：Hi xx You have successfully authenticated, but GitHub does not provid。e shell access.说明你连接成功了。（Using SSH over the HTTPS port）
1
2
3
$ ssh -T git@github.com
$ ssh -T git@gitlab.com
$ ssh -T git@git.coding.net

在github中找到 Settings--personal acess token--generate new token，设置全部权限，然后复制API token。

1
2
3

# keep it secret! Changing your password will generate a new token
$ git config --global github.user xx # github用户名
$ git config --global github.token xx # 右键粘贴API token。

II.I.II. 不同邮箱账户

如果你的项目邮箱不一致，用config文件管理它们，然后需要在项目根目录下进行单独配置。git配置多个SSH Key

生成另一个账号的ssh密匙并复制。将里面的内容添加到后台。同平台的第一个的SSH Key中也要记得添加？
1
2
3
4
$ ssh-keygen -t rsa -C "second_email" -f "wendu"
%　重命名为wendu

$ clip < ~/.ssh/wendu.pub
为了让SSH识别新的私钥，需将其添加到SSH agent中：
1
2
3
ssh-agent bash
ssh-add ~/.ssh/id_rsa
ssh-add ~/.ssh/wendu

生成touch ~/.ssh/config并打开vi ~/.ssh/config，编辑config：

# 配置ssh账户
Host github.com
HostName github.com
PreferredAuthentications publickey
IdentityFile ~/.ssh/id_rsa

Host gitlab.com
HostName gitlab.com
PreferredAuthentications publickey
IdentityFile ~/.ssh/id_rsa

Host coding.net
HostName github.com
PreferredAuthentications publickey
IdentityFile ~/.ssh/id_rsa

# 建一个别名，新建的帐号使用这个别名做克隆和更新。
# 比如，将Host替换成gmail.github.com，那么原地址是：git@github.com:test/Mywork.git，
# 替换后应该是：git@gmail.github.com:test/Mywork.git.
Host qq.coding.net
HostName coding.net
PreferredAuthentications publickey
IdentityFile ~/.ssh/wendu

2个账号，2个邮箱，自然不能使用之前设置的全局用户名和邮箱了。在项目根目录下进行单独配置。

$ git init

#1.取消global  
git config --global --unset user.name  
git config --global --unset user.email  

#2.设置每个项目repo的自己的user.email  
$ git config user.name "wendu"
$ git config user.email "second_email"

测试连接。

1
2
3

$ ssh -T git@git.coding.net
$ ssh -T git@qq.coding.net
# 之后输入 `yes` 并回车，就完成了。

II.II. git remote

为了便于管理，Git要求每个远程主机都必须指定一个主机名。git remote命令就用于管理主机名。

# 列出所有远程主机
$ git remote
# 参看远程主机的网址
$ git remote -v
# 添加远程主机
$ git remote add <主机名> <网址>
# 删除远程主机
$ git remote rm <主机名>
# 用于远程主机的改名
$ git remote rename <原主机名> <新主机名>

克隆版本库的时候，所使用的远程主机自动被Git命名为origin。如果想用其他的主机名，需要用git clone命令的-o选项指定。

1	$ git clone -o jQuery https://github.com/jquery/jquery.git

II.III. git fetch

一旦远程主机的版本库有了更新（Git术语叫做commit），需要将这些更新取回本地，这时就要用到git fetch命令。默认情况下，git fetch取回所有分支（branch）的更新。如果只想取回特定分支的更新，可以指定分支名。所取回的更新，在本地主机上要用"远程主机名/分支名"的形式读取。比如origin主机的master，就要用origin/master读取。

1 2	# 取回origin主机的master分支。 $ git fetch origin master

II.IV. git pull

git pull命令的作用是，取回远程主机某个分支的更新，再与本地的指定分支合并。

# 如果当前分支只有一个追踪分支，连远程主机名都可以省略。
$ git pull

# 远程分支是与当前分支合并
$ git pull origin next
# 实质上，这等同于先做git fetch，再做git merge。
$ git fetch origin
$ git merge origin/next

# 取回origin主机的next分支，与本地的master分支合并
$ git pull origin next:master

II.V. git stash

Git 工具 - 储藏（Stashing）

储藏可以获取你工作目录的中间状态，也就是你修改过的被追踪的文件和暂存的变更，并将它保存到一个未完结变更的堆栈中，随时可以重新应用。你也可以在其中一个分支上保留一份储藏，随后切换到另外一个分支，再重新应用这些变更。

$ git status
$ git stash

$ git status

$ git checkout otherbranch

# 默认使用最近的储藏并尝试应用它
$ git stash apply

$ git stash list
$ git stash apply stash@{2}

# apply 选项只尝试应用储藏的工作——储藏的内容仍然在栈上
# 移除
$ git stash list
$ git stash drop stash@{0}

# 重新应用被暂存的变更
$ git stash apply --index

II.VI. 仓库克隆

选择别人的远程仓库或者自建远程仓库。

建立本地仓库。

我们可以直接将服务器文件夹同步到本地：

# 把整个项目保存在本地仓库中
$ git clone git@gitlab.com:sli1989/sli1989.gitlab.io.git
$ cd sli1989.gitlab.io

# 同步github上的项目到本地
$ git fetch origin # 缓存区
$ git merge origin/master # 合并分支

默认 clone 的是这个仓库的 master 分支。如果最新的代码不在 master 分支上，可以使用checkout命令来把远程分支取到本地：

$ git branch -r #查看远程分支
# git branch -a #查看所有分支

$ git checkout origin/other-branch
$ git checkout -t origin/other-branch
# 使用-t参数，它默认会在本地建立一个和远程分支名字一样的分支折叠展开复制代码

$ git fetch origin other-branch:other-branch
# 通过fetch命令来建立的本地分支不是一个track branch，而且成功后不会自动切换到该分支上

不要在本地采用如下方法，这样建立的branch是以master为基础建立的，再pull下来的话，会和master的内容进行合并，有可能会发生冲突：

1
2
3

$ git branch other-branch
$ git checkout other-branch
$ git pull origin other-branch:other-branch

也可以自建本地仓库。在本地创建一个相同的项目，或者在目标文件夹中右键选择git bash here，进入命令行。
1
2
3
$ cd {本地路径} # 路径切换，如：cd e:/workspace
$ mkdir hello-world # 新建hello-world文件夹
$ cd hello-world

连接远程github项目（只需第一次设置）：

1	$ git remote add origin git@gitlab.com:sli1989/sli1989.gitlab.io.git

如有错误提示：fatal: remote origin already exists，执行

1 2	$ git remote rm origin $ git remote add origin git@github.com:sli1989/sli1989.github.io.git

II.VII. 添加文件

进入文件夹并初始化

$ cd hello-world    # 打开这个文件夹
# 若右键选择`git bash here`则以此目录作为当前目录进入命令行状态。

$ git checkout master
$ git init  # 初始化

新建文件

# （跳过）Touch 命令主要就是用来修改文件的访问时间和修改时间
$ touch README.md

$ git add README.md
$ git add .

II.VIII. 删除文件

查看本地分支下的文件
1
$ ls
先查看有哪些文件可以删除,但是不真执行删除
1
$ git rm -r -n */src/\*

删除命令

$ git rm test.txt
# 或
$ git rm raindow -r -f # 删除raindow文件夹及其下所有的文件
# 或
$ git rm -r --cached test.txt
# 如果只想从版本库中删除,但是本地仍旧保留的话,加上 cached 参数

告诉你哪些文件被删除了（跳过）
1
$ git status
如果误删，恢复到最新版本
1
$ git checkout -- test.txt

II.IX. 忽略设置

把不需要提交的文件放在忽略的文件夹中。在项目根目录下，和.git 同级目录下，新建一个.gitignore文件

II.X. Git commit

提交到版本控制仓库，必须填写注释信息。

$ git commit -m 'first commit'
$ git commit -a -m “add new file”

# 查看已经提交的文件和缓存区中有什么文件
$ git status
# 查看本地仓库修改了的内容
$ git diff

commit log 里面的 #XX 会显示成指向对应 Issue 的链接，对应地 Issue 里面也会出现这条 Issue 被哪个 commit 引用的提示。也可以使用 user/repo#45 引用其他仓库的 Issue 的链接。类似 close/closes/closed/fix/fixes/fixed/resolve/resolves/resolved #XX这样的，还会自动帮你把那条 Issue 给 close 掉。

参考链接：Git 工具 - 重写历史，用git Rebase -i来修改commit历史史。

合并多个commit

$ git checkout -b new-feature master

$ git commit ...
$ git commit ...

$ git checkout new-feature

# 从HEAD版本开始往过去数3个版本
$ git rebase -i HEAD~3
# 要合并的版本之前的版本号，不需要合并的 commit
$ git rebase -i bca36d

# 进入到 vi 的编辑模式
# 输入s，除了第一个 commit 前方的命令改成 squash 或 s，ctrl+c 退出编辑模式
# 输入 :wq 以保存并退出

# 如果有冲突，需要修改，修改的时候要注意，保留最新的历史，不然我们的修改就丢弃了。
# 修改以后要记得敲下面的命令：
$ git add .  
$ git rebase --continue  

# 放弃这次压缩的话
$ git rebase --abort  

# 如果没有冲突，或者冲突已经解决，则会出现编辑窗口

# 修改成新的 commit message
# 输入 :wq 以保存并退出

$ git checkout master
$ git merge new-feature

修改commit说明
- 修改最近一次提交说明。$ git commit --amend：这会把你带入文本编辑器，里面包含了你最近一次提交说明，供你修改。当你保存并退出编辑器，这个编辑器会写入一个新的提交，里面包含了那个说明，并且让它成为你的新的最近一次提交。
- 修改多个提交说明。使用rebase工具来衍合一系列的提交到它们原来所在的HEAD上而不是移到新的上。必须通过告诉命令衍合到哪次提交，来指明你需要重写的提交的回溯深度。

II.XI. git push

git push命令用于将本地分支的更新，推送到远程主机。所有本地操作都需要同步到远程仓库。

$ git push <远程主机名> <本地分支名>:<远程分支名>

$ git push -u origin master  

# 如果省略远程分支名，则表示将本地分支推送与之存在"追踪关系"的远程分支（通常两者同名），如果该远程分支不存在，则会被新建。
$ git push origin master
# 如果当前分支与远程分支之间存在追踪关系，则本地分支和远程分支都可以省略。
$ git push origin
# 如果当前分支只有一个追踪分支，那么主机名都可以省略。
$ git push
# 如果当前分支与多个主机存在追踪关系，则可以使用-u选项指定一个默认主机，这样后面就可以不加任何参数使用git push。
$ git push -u origin master
# 将本地的所有分支都推送到远程主机
$ git push --all origin
# 如果远程主机的版本比本地版本更新，推送时Git会报错，要求先在本地做git pull合并差异，然后再推送到远程主机。这时，如果你一定要推送，可以使用--force选项。
$ git push --force origin

# 默认只推送当前分支，这叫做simple方式。此外，还有一种matching方式，会推送所有有对应的远程分支的本地分支。
# Git 2.0版本之前，默认采用matching方法，现在改为默认采用simple方式。
$ git config --global push.default matching
# 或者
$ git config --global push.default simple

# 如果省略本地分支名，则表示删除指定的远程分支，因为这等同于推送一个空的本地分支到远程分支。
$ git push origin :master
# 等同于
$ git push origin --delete master

如有错误提示：error:failed to push som refs to...，执行
1
2
$ git pull origin master
$ git push origin master
如有错误提示：modified: xxx(modified content, untracked content)，删除目录下面的.git目录。重新git add .即可

如果需要推送到多个远程仓库:

添加一个远程仓库git remote add mirror git@github.com:theme-next/hexo-theme-next.git，利用 git push -u origin master和git push -u mirror master分别进行推送。
添加一个远程仓库git remote set-url --add github https://git.oschina.net/zxbetter/test.git，利用git push进行推送。

修改文件目录中的.git/config配置文件，这种方法其实和方法二是一样的。如果报错，先分别将本地版本推送到远程仓库，然后再把全部URL都加入。然后第一次提交时需要执行git push -u origin master，再往后就只需要执行git push就能把修改提交到上述三个远端仓库了。

[remote "origin"]
    url = git@github.com:sli1989/sli1989.github.io.git
    url = git@git.coding.net:sli1989/sli1989.git
    url = git@gitlab.com:sli1989/sli1989.gitlab.io.git
    fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
    remote = origin
    merge = refs/heads/master

方法二和三在 push 的时候比较方便。但是在 pull 的时候只能从方法三中的第一个 url 地址拉取代码。而方法一则不存在这种问题（可能要解决冲突）。所以，如果只进行 push 操作，推荐方法二和三，如果也要进行 pull 操作，推荐方法一。在 Git 2.0 将会更改默认的push动作为『只 push 当前 branch 到远端仓库』。如果想继续使用git push both命令需要手动设置一下git push的默认动作git config --global push.default matching。

II.XII. 撤销更改

回滚错误的修改
 Git 的 4 个阶段的撤销更改

了解清楚如何检查各种修改之后，我们开始尝试各种撤销操作。

已修改，未暂存：git checkout .或者git reset --hard
已暂存，未提交：git reset+git checkout .或者git reset --hard
已提交，未推送：git reset --hard origin/master
已推送：git reset --hard HEAD^ + git push -f

撤销已推送的一般步骤如下：

先git log 查看commit历史记录，找到commit-id。

本地代码库回滚：

git checkout the_branch
git revert <commit>
# 针对历史中任何一个提交，回滚到commit-id，它没有移除后面的提交
git reset --hard commit-id
# 从当前提交向前回溯，回滚到commit-id，将commit-id之后提交的commit都去除
git reset --hard HEAD^
# 删除最后1次的提交记录
git reset --hard HEAD~3
# 将最近3次的提交回滚

远程代码库回滚：

git add .
git commit -m "recovery theme"

git push -f origin master
# 删除远程 the_branch
git push origin :the_branch

对于 gitlab，可以进入当前仓库的设置中的 Protected branches 一项，将当前 branch 的 protected 临时去掉，等这次 push 完成，再重新设置回 protected 。

II.XIII. 分支管理

分支通俗说明，点击查看Git 分支 - 远程分支，Git 分支 - 何谓分支。

设置默认分支。WEB项目页setting-brances修改，设置了GitHub默认分支后，本地克隆后版本库的默认分支也将改变。

查看分支

1 2	$ git branch -r # 查看远程分支 $ git branch -a # 查看所有分支

切换分支
1
$ git checkout master

新建分支

$ git branch
# 完成新分支的创建
$ git checkout -b branchname
# 同时完成新分支的创建和分支切换。

$ git checkout -b newBrach oldBrach
# 在oldBrach的基础上，复制创建一个新分支。

# 获取tag的代码
$ git tag
$ git checkout -b branch_name tag_name

分支推送

1
2
3

$ git add hello1
$ git commit -m "add hello1"
$ git push -u origin branchname

把远程某各分支拉去到本地的branchname下，如果没有branchname，则会在本地新建branchname
1
$ git fetch origin branchname:branchname
获取远程分支remoteName 到本地新分支localName，并跳到localName分支
1
$ git checkout origin/remoteName -b localName

查看远程分支列表

1 2	$ git ls-remote $ git ls-remote git@github.com:username/name.git

删除本地分支，如果错误信息显示不能删除当前工作分支，需先切换到其他分支。

1
2
3

$ git branch -d branchname （删除merge了的分支）
$ git branch -D branchname （删除分支（不管它有没有merge））
# Git在删除分支时为避免数据丢失，默认禁止删除尚未合并的分支。参数-D则可强制删除尚未合并的分支。

删除远程分支

1 2	$ git push --delete origin branchname 或者 $ git push origin :branchname

删除HEAD分支
1
$ git push origin --delete HEAD

强制更新 Github上的分支

1 2	git push origin +master # 方法一，使用+强制更新 git push -f origin HEAD^:master # 方法二，使用-f参数

II.XIV. 分支合并

Merge、Rebase 的选择
 Git 工具 - 高级合并
 图解4种git合并分支方法
 Git 分支 - 分支的新建与合并

实际上在很多情况下，Pull Request所含提交有可能造成合并冲突，那样的话 GitHub 不再、也不能提供自动合并功能，就必须采用手工合并的方式。

编辑文件解决冲突，再 add 冲突文件，再 commit。
对于一些二进制文件，或者不同版本的第三方库引起的冲突。这时候不可能去手工编辑来解决冲突了，必须在两个版本的库中进行一个选择。

# 在新分支上面合并
# 创建分支
$ git checkout -b newbranch master
$ git pull git://github.com/mygoare/lehuo.git master

# $ git status
# $ git diff
# 在合并过程中有冲突的时候， git 会把修改记录直接保存在文件中，让开发者判断文件如何解决合并。
# HEAD，即本地的代码
# ==以下则是来自远程的更改
# 用编辑器修改相应文件，把不需要的内容删除即可

# 把修改提交到newbranch分支上
$ git add .
$ git status
$ git commit -m "merge mygoare's code"

# 再合并到master分支上
$ git checkout master
$ git merge newbranch
$ git push
$ git branch -D newbranch

如果git pull之后出现Please enter a commit to explain why this merge is necessary，如果要输入解释的话就需要:

按键盘字母 i 进入insert模式
修改最上面那行黄色合并信息，可以不修改
按键盘左上角Esc
输入:wq，按回车键即可

# Fork 后的项目
$ git clone https://lei-shilei@bitbucket.org/lei-shilei/scrapy-51job-jobs.git
$ cd scrapy-51job-jobs
# 源项目地址
$ git remote add updates https://MarsStone@bitbucket.org/MarsStone/scrapy-51job-jobs.git
$ git remote update updates
$ git rebase updates/master

# 在合并过程中有冲突的时候， git 会把修改记录直接保存在文件中，让开发者判断文件如何解决合并。

# 重新提交commit
$ git add filename
$ git commit -m "add edit filename"
# 自动跳转到随机生成的分之下，分支名称为 56f5e47

$ git checkout master
$ git merge 56f5e47
# 手工合并冲突
$ git add . && git commit -m "add *" && git push

从一个分支合并特定的commits到另一个分支：

合并某个分支上的单个commit

1 2	$ git checkout master $ git cherry-pick 62ecb3

合并某个分支上的一系列commits，假设你需要合并feature分支的commit76cada ~62ecb3 到master分支。
1
2
$ git checkout -b newbranch 62ecb3
$ git rebase --onto master 76cada^

II.XV. 更新 fork 的项目

# clone 自己的 fork 分支到本地
git clone git@github.com:sli1989/hexo-theme-next.git
cd <fold>
# 将原来的仓库指定为 upstream
git remote add upstream git@github.com:theme-next/hexo-theme-next.git
# fetch 源分支的新版本到本地
git fetch upstream
# 合并两个版本的代码
git merge upstream/master
# 将合并后的代码 push
git push origin branchname

II.XVI. Pull Request

先要fork别人仓库；
克隆fork的仓库到本机上并建立连接：
- git clone git@github.com:sli1989/hexo-theme-next.git
- git remote add origin git@github.com:sli1989/hexo-theme-next.git
新建一个新分支，作为Pull Request的源分支：git checkout -b pitch
编辑代码并commit：git commit -a -m "Further complement in README & fix pic_url"
push到自己的仓库中：git push -u origin pitch
用WEB浏览fork出来的仓库页面，点右上角的【Pull Request】按钮，发起一个Pull Request。弹出的表单自动设置自己的仓库为源仓库，并设置指定源分支、目标仓库和目标分支。

管理PR：

Just edit files in «Files changed» tab. But in this case u can't to edit new files, only files which shown in «Files changed» tab.

Use Git to Add and push.

# Add the other user as a remote
$ git remote add otheruser https://github.com/otheruser/yourrepo.git
# Fetch
$ git fetch otheruser
# Create a branch from their repo
$ git checkout -b otheruser-master otheruser/master
# Now make some changes and commit. Push to their repo
$ git push otheruser HEAD:master

# Merge them in if you're good to go:
$ git checkout master
$ git merge otheruser/master

Use Git in my forked repo.

$ git checkout -b newmaster mirror
$ git pull git://github.com/ifmos/hexo-theme-next.git master
$ git remote add ifmos https://github.com/ifmos/hexo-theme-next.git
# make some changes and commit
$ git add _config.yml
# git add -A
# git diffs
$ git status
$ git commit -m "update style"
$ git push ifmos HEAD:master

测试PR：

可以直接本地建立分支进行git pull：

git checkout -b zhuzhuyule-addLeftMode master
git pull git://github.com/zhuzhuyule/hexo-theme-next.git addLeftMode

git checkout master
git merge --no-ff zhuzhuyule-addLeftMode
git push origin master

git am命令用于将一个 patch 文件，合并进入当前代码。Github 对每个 PR 会自动生成一个 patch 文件。我们下载该文件，合并进本地代码，就可以在本地查看效果了。后面网址里面的/cbeust/testng是目标仓库，pull/17表示该仓库收到的第17个 PR。
1
$ curl -L http://github.com/cbeust/testng/pull/17.patch | git am
如果 PR 只包含一个 commit，那么也可以直接下载这个 commit 的 patch 文件。网址里面的/sclasen/jcommander是代码变更所在的那个仓库。
1
$ curl https://github.com/sclasen/jcommander/commit/bd770141029f49bcfa2e0d6e6e6282b531e69179.patch | git am

另一种方法是为 PR 创建一个远程分支，追踪提交者的仓库。

# 创建远程仓库，指向 PR 提交者的仓库
$ git remote add nullin git://github.com/nullin/testng.git

# 从该远程仓库拉取代码
$ git fetch nullin

# 将该仓库的某个分支合并到当前分支
$ git merge kneath/error-page

# 推送到自己的仓库
$ git push origin master

有时，PR 里面包含好几个 commit，但是你只想合并其中的一个或几个。这时可以使用cherry-pick命令，挑出你感兴趣的 commit。

# 建立远程分支，追踪提交者的仓库
$ git remote add nullin git://github.com/nullin/testng.git

# 从该远程仓库拉取代码
$ git fetch nullin

# 只将感兴趣的 commit 加入当前代码
$ git cherry-pick commit1
$ git cherry-pick commit2

# 推送到自己的仓库
$ git push origin master

II.XVII. 子模块管理

使用Git Submodule管理子模块
 git submodule 使用小结

添加子模块：git submodule add <repository> [<path>]（git submodule add https://github.com/sli1989/hexo-theme-next.git themes/next），添加后会多一个.gitmodules文件，文件的内容只是保存子模块的引用信息，包括路径和repo地址。

删除子模块：

# 首先我们反初始化
# git submodule deinit themes/next

$ rm -rf themes/next
# 这时，子模块文件被删除，同时 .gitmodules 文件中的相关信息被删除

$ cd .git
$ vim config # 删掉submodule信息

$ cd modules
$ rm -rf * # 千万别敲错了，或者可以到文件夹手动删除
# $ rm -rf .git/modules/themes/next

$ cd ../..

$ git rm --cached themes/next
$ rm ./gitmodules

# 或者直接全部删除
# git submodule deinit --force themes/next

本地修改更新子模块。默认下 submodule 的 HEAD 处于游离状态，在修改子项目的时候，要用 git checkout master 将当前的子模块分支切换到 master，然后才能做修改和提交。子项目一旦产生变动，有新的commit id，父项目必需产生一个提交，更新对子项目commit id的引用。子模块被提交后父项目会检测到，正常提交即可！

# 首先，我们进入子模块
cd thems/next
# 检出master分支
git checkout master

# 然后做修改
vim some-file.py

$ cd hexo
$ git status

# modified:   xx/xxxx/xxxx (new commits)

# add的时候注意再最后不要加 / 斜杠，否则会出现很棘手问题

$ git add xx/xxxx/xxxx
$ git commit -m "Get something done"
$ git push origin master

如果你不慎忘记切换到 master 分支，又做了提交，可以用 cherry-pick 命令挽救。

git checkout master
# 记住Warning的 change-id

git cherry-pick change-id
git push

直接从远程仓库更新子模块。使用CI部署时，本地子模块文件themes/next必须存在，同时需要更新子模块的commit信息。
- 在父项目的目录下直接运行git submodule foreach --recursive git pull origin master，一次全部更新所有的 submodule。
- 或者在子模块的目录下面更新git pull，使用和git单独的一个项目是一样的。建议大家git pull 之后，立即执行 git status，如果发现子模块有修改，立即执行 git submodule update。更复杂一些，如果你的 submodule 又依赖了 submodule，那么很可能你需要在 git pull 和 git submodule update 之后，再分别到每个 submodule 中再执行一次 git submodule update，这里可以使用 git submodule foreach 命令来实现： git submodule foreach git submodule update。

当clone项目时有子模块存在时，第一次是不会clone出子模块的，需要执行一些命令：

$ git clone git@gitlab.com:sli1989/sli1989.gitlab.io.git
$ cd sli1989.gitlab.io

# 初始化子模块 只在首次检出仓库时运行一次就行
$ git submodule init
# 将子模块的文件check出来 每次更新或切换分支后都需要运行一下
$ git submodule update
# $ git submodule update --init
# 现在所有子模块已经把被checkout到本地，是不是很棒！

# 也可以直接采用
$ git clone <repository> --recursive
$ git submodule update --init --recursive

II.XVIII. 里程碑管理

里程碑即tag，其管理和分支管理非常类似。里程碑和分支一样也是以引用的形式存在的，保存在.git/refs/tags/路径下。引用可能指向一个提交，但也可能是其他类型（Tag对象）。

轻量级里程碑：用git tag <tagname> [<commit>] 命令创建，引用直接指向一个提交对象<commit>。
带说明的里程碑：用git tag -a <tagname> [<commit>] 命令创建，并且在创建时需要提供创建里程碑的说明。Git会创建一个tag对象保存里程碑说明、里程碑的指向、创建里程碑的用户等信息，里程碑引用指向该Tag对象。
带签名的里程碑：用git tag -s <tagname> [<commit>] 命令创建。是在带说明的里程碑的基础上引入了PGP签名，保证了所创建的里程碑的完整性和不可拒绝性。

下面演示一下里程碑的创建和管理。

先在本地创建一个新提交。

1
2
3

$ touch hello1
$ git add hello1
$ git commit -m "add hello1 for mark."

本地创建里程碑mytag1、mytag2和mytag3。

1
2
3

$ git tag -m "Tag on initial commit" mytag1 HEAD^
$ git tag -m "Tag on new commit"     mytag2
$ git tag mytag3

查看新建立的里程碑。

$ git tag -l -n1
mytag1          Tag on initial commit
mytag2          Tag on new commit
mytag3          add hello1 for mark.

将本地里程碑推送到GitHub远程版本库。

$ git push origin refs/tags/*
Counting objects: 6, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (4/4), done.
Writing objects: 100% (5/5), 548 bytes, done.
Total 5 (delta 0), reused 0 (delta 0)
To git@github.com:sli1989/sli1989.github.io.git
 * [new tag]         mytag1 -> mytag1
 * [new tag]         mytag2 -> mytag2
 * [new tag]         mytag3 -> mytag3

删除本地里程碑。

1 2	$ git tag -d mytag3 Deleted tag 'mytag3' (was c71231c)

删除GitHub远程版本库中的里程碑。

1
2
3

$ git push origin :mytag3
To git@github.com:sli1989/sli1989.github.io.git
  [deleted]         mytag3

II.XIX. 永久删除文件与历史记录

从仓库总清除文件

1
2
3

git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch path-of-remove-file' --prune-empty --tag-name-filter cat -- --all
# path-of-remove-file是你要删除的文件的相对目录(相对于git repo的根目录),可以使用通配符*匹配文件进行批量删除
# 如果执行上述命令后出现的提示信息中有unchanged字样,说明repo中没有找到path-of-remove-file,请仔细检查路径和文件名是否正确

本地同步到服务器
1
git push origin master --force

回收磁盘空间

rm -rf .git/refs/original/
du -sh .git
git reflog expire --expire=now --all
git gc --prune=now
u -sh .git/*
git gc --aggressive --prune=now
du -sh .git

如何删除这些历史记录，形成一个全新的仓库，并且保持代码不变呢？

$ git checkout --orphan latest_branch
$ git add -A
$ git commit -am "init"
$ git branch -D master
$ git branch -m master
$ git push -f origin master

III. Git GUI

参考链接 Git可视化极简易教程 —— Git GUI使用方法。

Git GUI提供了Git可视化操作，避免命令行输入。

参考文献GitHub Desktop下载及使用，Github Desktop的使用教程。

GitKraken（推荐使用），这款工具操作比较方便，对没有太多git使用经验的新手比较友好，学习成本相对较低。尤其喜欢的一点就是它的分支和提交非常清晰。
Github Desktop不好用，其图形化界面功能有限。

III.I. Github Desktop

如果Git bash 配置好了，不需要Git GUI 权限校验。第一次才配置。如果不使用git bash 配置，需要单独配置Git GUI 。 1. 在目标文件夹右键，启动GIT GUI。 1. 【Step1-创建密钥】SHOW SSH KEY 1. 【Step2-添加密钥】登陆github系统。点击右上角的 Settings--->SSH and GPG keys ---> NEW SSH KEY，直接粘贴到key文本框中，点击 add key。title可以随便命名，然后点击add。

III.I.I. 仓库克隆

选择目标文件夹，选中后点击右键，选择Git GUI Here，选择“克隆已经存在的仓库”。
填写Source Location（源地址）和Target Directory
点击clone后，会提示下输入你github的用户名和密码，出现下面的界面，克隆完成。

III.I.II. 账号保存

如果不做设置的话，每次提交的时候，都会询问你填写密码。

（可跳过）【Step3.1-添加环境变量】我的电脑 - 属性 - 高级系统设置 - 环境变量 - 新建变量，变量名HOME，变量值 %USERPROFILE%
【Step3.2-创建账号文件】windows的管理员账号文件夹C:/Users/Administrator。新建一个名为_netrc的文件，填写你要保存的服务器地址及账号密码，保存。

III.I.III. 本地同步到服务器

修改属性配置-改为utf-8。
修改本地仓库内容。
点击RECAN，获取改动文件。
选择Stage Changed。
提交（Git commit）。提交的时候是要求必须要写备注的。提交则代表此前被添加ADD的文件已确认被提交到Git库了。需要注意的是，如果你改变代码的缩进（尽管没有修改内容），默认状态下会被识别为整个代码全部变更。
上传（Git push）。上传至远端服务器。

III.I.IV. 服务器同步到本地仓库

先来设置与远程地址的关联，Git remote：填写SSH地址与项目名。下面有3个选项：第一个：立刻获取最新改动（所以如果是本地克隆远程一个项目，也可以这样操作）。第二个：本地新建的项目，初始化远程仓库并发布过去。第三个：什么也不做。
获取仓库的最新改动Git fetch。选择从远程仓库哪个分支中获取更新，如果没有则只有主支。提示成功则改动的已经被存放到临时区了，你一会还需要进行合并操作，如果没有任何改动，则列表中是空的。
合并（Git merge）。不管你本地有没有代码，fetch之后呢，是都要merge的。选择合并 - 本地合并，然后选择本地的分支（如果你没有创建分支，则只有1个主支master）
冲突处理（Conflict）。合并的过程中可能会出现一些红色的文件与一堆叹号，只是有冲突的文件。在GUI界面正文区，正文区右键可以选择，Use local version（使用本地版本）或Use remote version（使用远程版本）。

IV. Git Pages

Git Pages有以下几个优点：

轻量级的博客系统，没有麻烦的配置
使用标记语言，比如Markdown
无需自己搭建服务器
可以绑定自己的域名

Github是一个通过Git进行版本控制的软件源代码托管服务，由GitHub公司（曾称Logical Awesome）的开发者Chris Wanstrath、PJ Hyett和Tom Preston-Werner使用Ruby on Rails编写而成。与GitHub建立好链接之后，就可以方便的使用它提供的Pages服务，Github Pages分两种，一种是你的GitHub用户名建立的username.github.io这样的用户&组织页（站），另一种是依附项目的pages。Hexo deploy可以部署到很多平台，具体可以参考这个链接。

Gitlab也是一个开源项目托管服务网站，Gitlab pages和Github pages的基本功能都一样，它支持无限的private项目。Gitlab pages和Github pages的基本功能都一样。使用GitLab Pages部署Hexo博客只需要把博客源代码push到repo，然后配置好GitLab Continuous Integration(GitLab CI)，就会自动渲染和部署Hexo博客。但是Gitlab pages有一些限制：不能把www子域名重定向到根域名，会同时存在两个版本的网站，这点非常不利于seo。

Coding.net 是一个面向开发者的云端开发平台，提供git/svn 代码托管，代码质量分析，在线WebIDE，项目管理，开发协作，冒泡社区，提供个人和企业公有云及企业私有云的服务。最近Coding Pages进行了改版，在托管的个人pages中添加Hosted by coding pages字样可以去掉等待页面，完成抓取工作，也可以用DNS做国内外分流，顺便解决访问速度慢的问题。

IV.I. 新建仓库

参考：GitLab Pages搭建Hexo博客，Example Hexo site using GitLab Pages

首次Git bash 配置。
建立仓库。
- Github完成注册后，创建与你的用户名相对应的公开仓库，格式必须是username.github.io。
- 在Gitlab完成注册。创建与你的用户名相对应的私密/公开仓库，格式必须是username.gitlab.io。
- 在Coding完成注册。点击创建新项目，填写相关信息，可以选择私密/公开仓库。项目名称里填上你的用户名（项目名称必须与coding的用户名一致？）可以创建任意名字的私密/公开仓库。进入项目页面，点击左侧栏的代码面板，选择 Pages 服务一项可以看到部署 Pages 的设置（公开项目点击 Pages 选项卡即可）。填写您欲部署的分支（默认为 coding-pages ），点击立即开启，稍等片刻即可完成部署并通过 {user_name}.coding.me 访问您的网站。

IV.II. 博客建立

详细内容查看HEXO博客的建立与调试。

IV.III. 博客部署

调试完成后，即可博客部署。可分为本地部署和在线部署。在未采用在线部署的时候，更新博客后总需要自己手动 hexo g -d，占用时间；使用在线部署之后（如Git Hooks，Travis CI和Gitlab CI），只需要执行 git push，剩下的静态页面构建过程就由服务器完成。

IV.III.I. 本地部署

Hexo 提供了快速方便的一键部署功能，让您只需一条命令就能将网站部署到服务器上。

在本地项目根目录中右键git bash，测试连接，首次推送设置，以后不需要：

$ git init
$ ssh -T git@github.com
$ git remote add origin git@github.com:sli1989/sli1989.github.io.git

$ ssh -T git@git.coding.net
$ git remote add origin git@git.coding.net:sli1989/sli1989.git

配置HEXO部署环境。
1
$ npm install hexo-deployer-git --save

修改站点配置文件中部署参数。一个正确的部署配置中至少要有 type 参数，可同时使用多个 deployer。YAML依靠缩进来确定元素间的从属关系。因此，请确保每个deployer的缩进长度相同，并且使用空格缩进。

~/hexo/_config.yml

deploy:
- type: git
  repo: 'git@git.coding.net:sli1989/sli1989.git'
  branch: master
- type: git
  repo: 'git@github.com:sli1989/sli1989.github.io.git'
  branch: master

或者

~/hexo/_config.yml

# deploy沿着左边界写
# type和repo左边空格是2个，多一个少一个都不行
# git与type后面的:中间要有一个空格
# github和coding要与repo后边的:对齐
deploy:
  type: git
  repo:
      github: git@github.com:sli1989/sli1989.github.io.git
      coding: git@git.coding.net:sli1989/sli1989.git
  branch: master

对于coding pages，需要在source/需要创建一个空白文件Staticfile，因为 coding.net需要这个文件来作为以静态文件部署的标志。
1
2
cd source/
touch Staticfile #名字必须是Staticfile
Hexo 提供了快速方便的一键部署功能，执行命令 hexo clean && hexo g -d ，就可以在 username.coding.me 或者username.github.io看到你的博客了。

IV.III.II. Git Hooks

通过配置 Git Hooks 实现自动部署 Hexo

IV.III.III. Travis CI

持续集成，Continuous integration，简称CI。

Travis CI 是一个基于 Github 仓库的持续集成工具，使用一个GitHub Page分支来管理所有博客的源代码，然后由CI编译发布到master主分支。

wafer.li的博文详细介绍了配置步骤¹ ²。

未测试

首先使用GitHub账号登入在Travis CI，并在Travis中开启GItHub Page的持续集成。
然后设定自动构建过程的配置文件，在本地的blog的git库的顶级目录中新加文件.travis.yml。
通过 GItHub 新增加一个 Personal access token（记得复制），从而使得CI能够push代码。
最后，我们在本地代码中新建分支source_code，在该分支下执行提交代码。
1
2
3
git add . -A
git commit -m "test CI"
git push

~/hexo/.travis.yml文件内容参考：

配置文件中的${pandoc}是pandoc的下载地址，配置在CI的变量中，后面会具体讲如何设置该变量，同样的${token},${GH_REF}同理。after_script中的user.name，user.email，需要改成你自己的git用户名和邮箱，global中的- GH_REF: github.com/peterxugo/peterxugo.github.io.git需要换成自己的仓库地址。

~/hexo/.travis.yml

language: node_js
node_js: stable
cache:
  - pandoc
  - hexo-cli
  - hexo-renderer-pandoc
install:
  - wget ${pandoc}
  - sudo dpkg -i pandoc*.deb
  - npm install -g hexo-cli
  - npm install hexo-renderer-pandoc --save
script:
  - hexo clean
  - hexo g
after_script:
  - cd ./public
  - git init
  - git config user.name "peterxu"
  - git config user.email "peterxugo@gmail.com"
  - git add .
  - git commit -m "Update"
  - git push --force --quiet "https://${token}@${GH_REF}" master:master
branches:
  only:
    - source_code
env:
 global:
   - GH_REF: github.com/peterxugo/peterxugo.github.io.git

~/hexo/.travis.yml

sudo: required
dist: trusty
group: edge
language: node_js
node_js: stable
python:
  - "3.4"
branches:
  only:
  - master
cache:
  apt: true
  yarn: true
  directories:
  - node_modules
addons:
  ssh_known_hosts:
  - changkun.us:38438
before_install:
  - openssl aes-256-cbc -K $encrypted_3277e6996e70_key -iv $encrypted_3277e6996e70_iv -in .travis/travis.enc -out ~/.ssh/id_rsa -d
  - chmod 600 ~/.ssh/id_rsa
  - git config --global user.name "Changkun Ou"
  - git config --global user.email "hi@changkun.us"
  - sudo apt-get -qq update
  - sudo apt-get install -y pandoc
  - sudo apt-get -y install python3-pip python-dev
  - sudo pip3 install -U setuptools
  - sudo pip3 install -U virtualenvwrapper
  - python3 -V
  - pip3 -V
  install:
  - pip3 install -r requirements.txt
  - npm install hexo-cli -g
  - yarn
  - git clone https://github.com/changkun/hexo-theme-next themes/hexo-theme-next
  - cp config/site_config.yml _config.yml
  - cp config/theme_config.yml themes/hexo-theme-next/_config.yml
script:
  - make repair
  - make g
  - make mini
after_success:
  - make dep

IV.III.IV. Gitlab CI

使用Gitlab自动部署，你只需要在项目的根目录下添加一个.gitlab-ci.yml文件，用来指导服务器如何处理你提交的源文件。然后把博客源代码push到repo，就会自动渲染和部署Hexo博客。也可以配置将其推送到 github 和 coding，，也可以直接到gitlab上去写markdown源文件。

先按照Hexo-BLOG搭建和调试本地博客，确保无误后新建（也可以直接改名）目录名为sli1989.gitlab.io
将文件scaffolds, source, themes, .gitignor, .gitlab-ci.yml, _config.yml, package.json复制，同时要将themes/next/目录下的.git文件夹删除，也删除博客目录的.git文件夹再重新配置。
配置.gitlab-ci.yml文件，可以分别进行https链接和ssh链接。

实际上 Hexo 的文章更改时间就是 markdown 文件的最后修改时间。由于 CI 在构建的时候，总是重新 clone repo，这就造成了所有文件的最后修改时间都是最新的 clone 时间；实际上，这并不是 CI 的问题，而是 git 的问题，git 由于分布式的原因，并不会保留文件的最后修改时间；不过，作为一个博客系统来说，我们可以采用 git 的最后 commit 时间来替代，这样子就能恢复文件的修改时间了。

博文解决了 CI 总是更新旧博客的问题。不同的是，GITLAB的GIT_DEPTH是人工设置。

~/hexo/.gitlab-ci.yml

#  an experimental feature
variables:
  GIT_DEPTH: "1000000"

before_script:
  - export TZ='Asia/Shanghai'
  - git config --global user.name "sli1989"
  - git config --global user.email "im.sai.li@outlook.com"
  # Restore last modified time
  - "git ls-files -z | while read -d '' path; do touch -d \"$(git log -1 --format=\"@%ct\" \"$path\")\" \"$path\"; done"

IV.III.IV.I. HTTPS链接

以下.gitlab-ci.yml配置³使用Pandoc渲染器，插件的使用跟Hexo-BLOG本地调试一致，需要什么添加什么。

这里比较重要的：

如果您的密码中包含[:@]等符号，请您对密码做urlencode处理，如@=%40。
github仓库的地址设置：https://github.access.token@github.com/github.username/github.usernam.github.io.git，github.access.token第一次生成时才能看到，之后只能通过git config --list查看复制（参考使用hexo+gitlab+ci+github Pages 持续集成写博客）。
对于Coding pages的推送，HTTPS 方式 push 大文件可能引发错误。可以执行 git config http.postBuffer 524288000 设置更大的限制值。

Success

~/hexo/.gitlab-ci.yml

before_script:
  - apt-get update -qq && apt-get install -y -qq pandoc

image: node:6.10.2

pages:
  cache:
    paths:
    - node_modules/
  script:
  - npm install hexo-cli -g
  - npm install
  - npm uninstall hexo-filter-auto-spacing --save
  - npm uninstall hexo-renderer-marked --save
  - npm install hexo-renderer-pandoc --save
  - npm install hexo-generator-feed --save
  - npm install hexo-generator-sitemap --save
  - npm install hexo-generator-baidu-sitemap --save
  - npm install hexo-generator-searchdb --save
  - npm install hexo-generator-topindex --save
  - npm install hexo-symbols-count-time --save
  - ./node_modules/hexo/bin/hexo generate
  - cd ./public
  - git init
  - git config --global user.name "sli1989"
  - git config --global user.email "im.sai.li@outlook.com"
  - git config --global push.default simple
  - git add .
  - git commit -m "gitlab-auto-deploy"
  - git push --force --quiet --set-upstream https://github_access_token@github.com/username/username.github.io.git master # replace github_access_token
  - git config http.postBuffer 524288000
  - git push --force --quiet --set-upstream https://username:password@git.coding.net/username/reponame.git master # replace username & password

  artifacts:
    paths:
    - public
  only:
  - master

IV.III.IV.II. SSH链接

官方配置推荐使用的是SSL链接，用gitlab-ci持续集成部署hexo博客和GitLabCI通过ssh进行自动部署介绍了使用过程。

Success

生成部署公钥。与账户 SSH 公钥生成一样，但不能重复使用。打开命令行终端输入 $ ssh-keygen -t rsa -C "im.sai.li@outlook.com" -f ~/.ssh/deploy_rsa，连续点击 Enter 键即可。
添加部署公钥。用文本编辑器打开deploy_rsa.pub文件，复制全部内容。
- 登录 Coding.net，进入目标项目，点击『设置 -> 部署公钥 ->新建部署公钥』，将复制的内容填写到『公钥内容』一栏，公钥名称自定义为gitlab-deploy。点击『添加』，勾选部署公钥设置里的『授予推送权限』，然后输入账户密码即可成功添加部署公钥。
- 登录 github，进入目标项目，点击『设置 -> 部署公钥 ->新建部署公钥』，将复制的内容填写到『公钥内容』一栏，公钥名称自定义为gitlab-deploy。点击『添加』，勾选部署公钥设置里的『授予推送权限』，然后输入账户密码即可成功添加部署公钥。
添加部署密匙。进入Gitlab项目页面，SETTINGS-CI/CD-Secret variables，复制密匙\Administrator\.ssh\deploy_rsa内容，名称自定义为DEPLOY_PRIVATE_KEY并记住。

设置.gitlab-ci.yml：

~/hexo/.gitlab-ci.yml

# variables:
  # GIT_DEPTH: "1000000"
// 注意替换 DEPLOY_PRIVATE_KEY
before_script:
  - export TZ='Asia/Shanghai'
  - git config --global user.name "sli1989"
  - git config --global user.email "im.sai.li@outlook.com"
  # Restore last modified time
  - "git ls-files -z | while read -d '' path; do touch -d \"$(git log -1 --format=\"@%ct\" \"$path\")\" \"$path\"; done"
  # Install ssh-agent if not already installed, it is required by Docker.
  # (change apt-get to yum if you use a CentOS-based image)
  - 'which ssh-agent || ( apt-get update -y && apt-get install openssh-client -y )'
  # Run ssh-agent (inside the build environment)
  - eval $(ssh-agent -s)
  # Add the SSH key stored in SSH_PRIVATE_KEY variable to the agent store
  - ssh-add <(echo "$DEPLOY_PRIVATE_KEY")
  # For Docker builds disable host key checking. Be aware that by adding that
  # you are suspectible to man-in-the-middle attacks.
  # WARNING: Use this only with the Docker executor, if you use it with shell
  # you will overwrite your user's SSH config.
  - mkdir -p ~/.ssh
  - '[[ -f /.dockerenv ]] && echo -e "Host *\n\tStrictHostKeyChecking no\n\n" > ~/.ssh/config'
  # In order to properly check the server's host key, assuming you created the
  # SSH_SERVER_HOSTKEYS variable previously, uncomment the following two lines
  # instead.
  # - mkdir -p ~/.ssh
  # - '[[ -f /.dockerenv ]] && echo "$SSH_SERVER_HOSTKEYS" > ~/.ssh/known_hosts'

  # install pandoc
  # - apt-get update -qq && apt-get install -y -qq pandoc
  # - wget https://github.com/jgm/pandoc/releases/download/2.7/pandoc-2.7-1-amd64.deb
  - wget https://github.com/jgm/pandoc/releases/download/1.19.2.1/pandoc-1.19.2.1-1-amd64.deb
  - dpkg -i ./pandoc-1.19.2.1-1-amd64.deb

image: node:10.15.0

pages:
  cache:
    paths:
    - node_modules/
  script:
  - npm install -g hexo-cli
  - npm install
  - npm uninstall hexo-filter-auto-spacing --save
  - npm uninstall hexo-renderer-marked --save
  - npm install hexo-renderer-pandoc --save
  - npm install hexo-generator-feed --save
  - npm install hexo-generator-topindex --save
  - npm install hexo-generator-sitemap --save
  - npm install hexo-generator-baidu-sitemap --save
  - npm install hexo-generator-searchdb --save
  - npm install hexo-symbols-count-time --save
  - hexo clean
  - hexo generate
  - git config --global user.name "sli1989"
  - git config --global user.email "im.sai.li@outlook.com"
  - hexo deploy

  artifacts:
    paths:
      - public
  only:
    - master

在本地项目根目录中右键git bash，测试连接，首次推送设置，以后不需要：

1
2
3

$ git init
$ ssh -T git@gitlab.com
$ git remote add origin git@gitlab.com:sli1989/sli1989.gitlab.io.git

推送本地修改，也可以直接使用Atom安装Git-Control插件，实现Git操作，点击查看Atom使用指南和Markdown语法。
1
2
3
$ git add .
$ git commit -m "update post"
$ git push -u origin master
然后可以在博客仓库的Pipelines中查看到Hexo渲染和部署的过程，可以在Pipelines中查看构建失败的原因。构建成功后，可以访问 https://sli1989.gitlab.io/查看搭建效果。

IV.IV. 博客备份

如果我想在另外一台设备上面写博客，必须将整个项目拷贝过来，完成之后要保持两台设备的内容是一致的。在这种情况下一般会将整个项目都托管到 Github/Coding 上面。但是这又会导致另外一个问题，每次有改动的时候不但要部署博客，还要提交项目的代码，这又增加了操作的步骤。

CI自动部署解决这种烦恼，让所有工作交给服务器。因此推荐使用自动部署的方式进行备份，如Git Hooks，Travis CI和Gitlab CI。

IV.IV.I. 上传

hexo g 命令就是根据_config.yml，source目录文件以及themes目录下文件生成博客文件的。同样当我们运行hexo clean命令时，public目录被删除了。因此，需要备份的文件就是scaffolds, source, themes, .gitignor, .gitlab-ci.yml, _config.yml, package.json，这个就是用于多终端同步关键的部分。

配置.gitignore文件。

~/hexo/.gitignore

.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/

同步到远程仓库的Hexo分支。这样你的Github项目中就会多出一个Hexo分支。

git add . #添加目录下所有文件
git commit -m "Blog Source Hexo"
git branch hexo
git checkout hexo
git remote add origin git@github.com:sli1989/sli1989.github.io.git
git push origin hexo

IV.IV.II. 下载

在B电脑上新建hexo文件夹。拉下远程仓库文件

1 2	git init git clone origin hexo git@github.com:sli1989/sli1989.github.io.git

或者

git init
git remote add origin git@github.com:sli1989/sli1989.github.io.git
git checkout -b hexo
git pull origin hexo

然后进行博客配置，安装插件。

# 安装必要的所需组件，不用再init；否则之前的hexo配置参数会重置

$ npm install -g hexo-cli
$ npm install hexo --save

# 安装依赖库
$ npm install

# 安装部署相关配置
$ npm install hexo-deployer-git

然后写文章，部署博客，同时更新Hexo分支。

hexo new post "new blog name"  
# 新建一个.md文件，并编辑完成自己的博客内容

git add . #添加目录下所有文件
git commit -m "UPDATE Blog Source Hexo"
git push origin hexo  # 更新Hexo分支
hexo d -g

在不同的终端已经做完以上第一次配置后，以后只需执行以下命令进行更新即可。

git pull origin hexo  
# 先pull完成本地与远端的融合

git add .
git commit -m "xx"
git push origin hexo
hexo d -g

V. Hexo BLOG

参考链接：手把手教你使用Hexo + Github Pages搭建个人独立博客，小白独立搭建博客--Github Pages和Hexo简明教程，Hexo+Github搭建个人博客(二)——配置&主题。

To work locally with this project, you'll have to follow the steps below: Read more at Hexo's documentation.

V.I. 博客初始化

下载安装Node.js。
下载安装Git，进行Git Bash 配置。

博客环境配置：所有必备的应用程序安装完成后，根据自己喜好选择存放目录，右键点击Git Bash Here，进入Git命令框，执行以下操作。

# 安装 Hexo
$ npm install -g hexo-cli

# 文件夹取名为hexo
$ hexo init hexo
# 注意init会把之前的hexo配置参数会重置
# 会自动安装依赖库 如果没有 手动安装
# $ npm install

博客环境配置完成后，可以在站点配置文件~/blog/_config.yml中配置大部分的参数（如何配置）。要记得把URL换成你的博客地址（http://username.github.io或自定义域名）。
- package.json是应用程序的信息。EJS, Stylus 和 Markdown renderer 已默认安装，您可以自由移除。
- 当您新建文章时，Hexo 会根据模版scaffolds 文件夹来建立文件。
- 资源文件夹source是存放用户资源的地方。
- 除 _posts 文件夹之外，开头命名为 _ (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。
- Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件会被拷贝过去。
- 主题themes 文件夹。Hexo 会根据主题来生成静态页面。
主题选择。进入Hexo的官网主题专栏，挑选喜欢的主题，复制它的github地址，进入/themes目录，右键Git Bash，在命令行输入。下载完成后，打开站点配置文件~/blog/_config.yml，修改参数为：theme: next，然后编辑主题配置文件~/blog/themes/next/_config.yml进行NexT主题设置。
1
git clone https://github.com/theme-next/hexo-theme-next themes/next

V.II. 博客调试

支持本地预览调试。输入以下命令，然后打开浏览器，进入 http://localhost:4000/ 即可进行博客预览。

1
2
3

$ hexo clean // 每次调试时建议使用
$ hexo g # 或者hexo generate
$ hexo s # 或者hexo server

推荐使用F12，改到自己想要的样式，然后 Copy 到custom.styl文件即可。使用方法可以参考操作流程图和自定义页面样式

V.III. HEXO升级

更新升级可以享受很多新功能，不用自己去修改文件了。

升级Node.js： npm install n -g+n latest
升级hexo: npm update -g hexo或者安装指定版本npm install hexo@3.7.0
升级插件: npm update

V.IV. NEXT升级

目前升级 NexT 主题的时候并不是非常的流畅。目前 NexT 将会使用 Hexo 的 Data Files ，将所有的主题配置放置在站点的 source/_data/next.yml 文件中。原先放置在站点配置文件~/blog/_config.yml中的选项可以迁移到新的位置，同时，主题配置文件~/blog/themes/next/_config.yml可以不用做任何修改。若后续版本有配置相关的改动时，你仅需在 next.yml 中做相应调整即可。

1
2
3

rm -r themes/next
git clone https://github.com/theme-next/hexo-theme-next themes/next
rm -fr ./themes/next/.git/

备份恢复个性化设置：

手动备份修改的主题文件；
利用SED命令自动修改新主题文件；
使用子模块更新方法：源码仓库中可以看到themes/next目录后有个@xxxxxx，指向子模块的一个提交，点击可以跳转到sli1989/hexo-theme-next仓库。

V.IV.I. 子模块更新

进入NexT项目源码页面，点击fork，这样就将最新的主题源码fork成为自己的项目。

$ cd hexo_blog
$ git rm -r --cached themes/next/
$ git submodule add git@github.com:sli1989/hexo-theme-next.git themes/next/
# $ git add .
# $ git commit -m 'add theme next as a submodule'
# $ git push -u origin master

导入子项目后，站点根目录会多出.gitmodules文件，其内容如下：

1
2
3

[submodule "themes/next"]
    path = themes/next
    url = https://github.com/sli1989/hexo-theme-next.git

本地部署。

为了方便与源项目代码进行同步，设置远程仓库。

$ cd themes/next
$ git remote add upsteam https://github.com/theme-next/hexo-theme-next

# 查看当前的远程仓库
$ git remote -v

如果发现远程仓库有更新，进行拉取与合并，以及合并冲突处理。建议使用rebase命令更新sli1989/hexo-theme-next.git。

$ git fetch upstream
$ git merge upstream/master
# 等价于 $ git pull

# 手动解决合并冲突
$ vim conflict_files

# $ git submodule update

# 解决冲突完毕    
# 建议使用rebase命令    
$ git add .                            
$ git commit 'merge upstream updates'
$ git push -u origin master

CI部署。yml的子模块自动更新script未测试通过（Using Git submodules with GitLab CI），目前通过本地更新子模块长传Gitlab进行部署。

# git submodule update --remote --recursive
cd themes/next
git checkout master
git fetch --all
git reset --hard origin/master
git pull
cd ../../
# gitlab推送
git add .
git commit -m "update next"
git push -u origin master

~/hexo/.gitlab-ci.yml

+ variables:
+   GIT_SUBMODULE_STRATEGY: recursive

pages:
  script:
+   - git submodule init
+   - git submodule update
+   # - git submodule update --init

V.V. NEXT个性化

感谢以下博文：

打造个性超赞博客Hexo+NexT+GithubPages的超深度优化

Hexo Configuration

hexo的next主题个性化配置教程

hexo高阶教程：next主题优化之加入网易云音乐、网易云跟帖、炫酷动态背景、自定义样式，打造属于你自己的定制化博客

为Hexo Next主题添加哈林摇特效（五）

Hexo+Next主题优化

Hexo 安装主题的方式非常简单，只需要将主题文件拷贝至站点目录的 themes 目录下，然后修改下配置文件即可。在 _config.yml 中可以修改大部份的配置。

encrypt the content of a post：hexo-encrypt
Enhanced code highlighting using highlight.js for Hexo ： hexo-filter-highlight
~~hexo-renderer-marked： Hexo的文章内容默认是不支持emoji表情的。Add support for Markdown. This plugin uses marked as render engine. 配置方法。~~
Embed aplayer in Hexo posts/pages：hexo-tag-aplayer
~~一个为Hexo编写的网易云音乐标签插件：hexo-tag-cloudmusic~~
~~A Flask Music Project：163music-APlayer-you-get-docker~~

V.V.I. 点击侧栏头像回到首页

设置~/hexo/themes/next/_config.yml中的头像avatar: /uploads/avatar.gif

修改如下代码：

~/hexo/themes/next/layout/_macro/sidebar.swig

+        <a href="/" class="site-author-image" rel="start" style="border:none">
          <img class="site-author-image" itemprop="image"
               src="{{ url_for( theme.avatar | default(theme.images + '/avatar.gif') ) }}"
               alt="{{ theme.author }}" />
+        </a>

V.V.II. 自定义样式

NexT v6.0.2 引入了个性化文件设置，所有个性化变量、样式等都可以通过styles: source/_data/styles.styl进行添加，使用的时候，只需要添加~/hexo/source/_data里面的文件即可。

~/hexo/source/_data/styles.styl或 ~/hexo/themes/next/source/css/_custom/custom.styl涉及的个性化内容：

修改正文顶部与标题行间距，添加如下：
~/hexo/source/_data/styles.styl
1
2
3
.posts-expand .post-meta {
margin: 10px 0 10px 0;
}
调整一级标题和正文的间距，添加
~/hexo/source/_data/styles.styl
1
2
3
.post-body h1 {
margin: 0 0 15px 0;
}
调整段落下部间距，添加：
~/hexo/source/_data/styles.styl
1
2
3
.post-body p {
margin-bottom: 0.8em;
}

修改块引用样式。参考CSS-blockquote引用样式，添加：