企业官网建设流程全解析

• 文档
• 教程

本篇指南以 linux-command 仓库收录的 command/git.md 文档为核心，系统梳理 Git 作为分布式版本控制系统的完整命令体系：从语法与核心选项、全局配置、SSH 多账号与免密登录，到分支管理、远程多源推送、submodule、标签、日志、历史重写以及常见报错解决。阅读本文后，你将掌握一套可直接复制运行的 Git 日常操作命令集，覆盖从新建仓库到团队协作回滚的全生命周期场景。

Git 的由来：为什么需要分布式版本控制

git 命令是目前世界上最先进的分布式版本控制系统。很多人都知道，Linus 在 1991 年创建了开源的 Linux，从此 Linux 系统不断发展，已经成为最大的服务器系统软件。Linus 虽然创建了 Linux，但 Linux 的壮大是靠全世界热心的志愿者参与的，这么多人在世界各地为 Linux 编写代码，那么 Linux 的代码是如何管理的呢？

事实是，在 2002 年以前，世界各地的志愿者把源代码文件通过 diff 的方式发给 Linus，然后由 Linus 本人通过手工方式合并代码。为什么不把 Linux 代码放到 CVS、SVN 这些免费的版本控制系统里？因为 Linus 坚定地反对 CVS 和 SVN——这些集中式的版本控制系统不但速度慢，而且必须联网才能使用。商用的版本控制系统虽然好用，但付费模式与 Linux 的开源精神不符。

到了 2002 年，Linux 系统已经发展了十年，代码库之大让 Linus 很难继续手工管理，社区也对这种方式表达了强烈不满，于是 Linus 选择了商业版本控制系统 BitKeeper，BitMover 公司授权 Linux 社区免费使用。但 2005 年，开发 Samba 的 Andrew 试图破解 BitKeeper 的协议，被 BitMover 公司发现，于是 BitMover 要收回 Linux 社区的免费使用权。

结果 Linus 花了两周时间自己用 C 写了一个分布式版本控制系统，这就是 Git！一个月之内，Linux 系统的源码已经由 Git 管理。Git 迅速成为最流行的分布式版本控制系统，尤其是 2008 年 GitHub 网站上线后，它为开源项目免费提供 Git 存储，无数开源项目开始迁移至 GitHub，包括 jQuery、PHP、Ruby 等。

语法与核心选项

Git 命令的完整语法如下：

git [--version] [--help] [-C <path>] [-c name=value] [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path] [-p | --paginate | --no-pager] [--no-replace-objects] [--bare] [--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>] <command> [<args>]

其中git <command>的常用子命令及其作用如下表：

这些子命令正是本仓库中 git 文档（command/git.md）展开讲解的主体，下文将按「配置 → 日常场景 → 本地 → 分支 → 远端 → 高级技巧」的顺序逐一展开。

全局配置

首先要配置账号信息，用ssh -T git@github.com测试是否连通。

修改项目中的个人信息

git help config # 获取帮助信息，查看修改个人信息的参数 git config --global user.name "your name" # 修改全局名字 git config --global user.email "you@example.com" # 修改全局邮箱 git config --list # 查看配置的信息

配置自动换行

自动转换坑太大，提交到 git 时自动将换行符转换为 LF：

git config --global core.autocrlf input

打造自己的 git 命令（别名）

通过 alias 配置可以大幅缩短高频命令的输入：

git config --global alias.st status git config --global alias.br branch git config --global alias.co checkout git config --global alias.ci commit

配置好后再输入 git 命令就不用再输入一大段了，例如要查看状态只需：

git st

中文乱码的解决方案

在查看状态时，如果 git status 对中文显示为转义序列（如\344\272\247\345\223\201...），执行下面命令即可解决：

git config --global core.quotepath false

SSH 密钥与多账号配置

创建 SSH 密钥

这个密钥用来跟代码托管平台通信，在本地终端里生成然后上传到平台：

ssh-keygen -t rsa -C 'you@example.com' # 生成密钥 ssh-keygen -t rsa -C "you@example.com" -f ~/.ssh/ww_rsa # 指定生成目录文件名字 ssh -T git@github.com # 测试是否成功

多账号 ssh 配置

1. 生成指定名字的密钥

ssh-keygen -t rsa -C "邮箱地址" -f ~/.ssh/jslite_rsa会生成jslite_rsa和jslite_rsa.pub这两个文件。

2. 密钥复制到托管平台上

vim ~/.ssh/jslite_rsa.pub打开公钥文件jslite_rsa.pub，并把内容复制至代码托管平台上。

3. 修改 config 文件

vim ~/.ssh/config # 修改config文件，如果没有创建 `config`

Host jslite.github.com HostName github.com User git IdentityFile ~/.ssh/jslite_rsa Host work.github.com HostName github.com # Port 服务器 open-ssh 端口（默认：22，默认时一般不写此行） # PreferredAuthentications 配置登录时用什么权限认证 # publickey|password publickey|keyboard-interactive等 User git IdentityFile ~/.ssh/work_rsa

• Host：别名，可以随便命名；
• HostName：一般是网站，如git@ss.github.com:username/repo.git填写github.com；
• User：通常填写git；
• IdentityFile：使用的公钥文件地址。

4. 测试

ssh -T git@jslite.github.com # `@` 后面跟上定义的 Host ssh -T work.github.com # 通过别名测试 ssh -i ~/公钥文件地址 Host别名 # 如 ssh -i ~/.ssh/work_rsa work.github.com

5. 使用

# 原来的写法 git clone git@github.com:<jslite的用户名>/learngit.git # 现在的写法 git clone git@jslite.github.com:<jslite的用户名>/learngit.git git clone git@work.github.com:<work的用户名>/learngit.git

6. 注意

如果修改了 id_rsa 的名字，需要将 ssh key 添加到 SSH agent 中：

ssh-add ~/.ssh/jslite_rsa ssh-add -l # 查看所有的 key ssh-add -D # 删除所有的 key ssh-add -d ~/.ssh/jslite_rsa # 删除指定的 key

免密码登录远程服务器

ssh-keygen -t rsa -P '' -f ~/.ssh/aliyunserver.key ssh-copy-id -i ~/.ssh/aliyunserver.key.pub root@192.168.182.112 # 这里需要输入密码一次

编辑~/.ssh/config：

Host aliyun1 HostName 192.168.182.112 User root PreferredAuthentications publickey IdentityFile ~/.ssh/aliyunserver.key

配置完成后，可以直接通过ssh aliyun1登录，不需要输入 IP 地址和密码。

HTTPS 协议下提交代码免密码

通过git clone https://github.com/username/rep.git方式克隆的项目，提交时可能需要密码。解决办法：进入当前克隆的项目vi rep/.git/config编辑 config，按照下面方式修改 url，即可提交代码不用输入密码：

[core] repositoryformatversion = 0 filemode = true bare = false logallrefupdates = true ignorecase = true precomposeunicode = true [remote "origin"] - url = https://github.com/username/rep.git + url = https://用户名:密码@github.com/username/rep.git fetch = +refs/heads/*:refs/remotes/origin/* [branch "master"] remote = origin merge = refs/heads/master

常见使用场景

文件推向 3 个 git 库

Git 是分布式代码管理工具，可以支持多个仓库。在 git 里，服务器上的仓库在本地称之为 remote。个人开发时多源可能用得不多，但多源其实非常有用。

1. 增加 3 个远程库地址

git remote add origin https://github.com/JSLite/JSLite.git git remote set-url --add origin https://gitlab.com/wang/JSLite.js.git git remote set-url --add origin https://oschina.net/wang/JSLite.js.git

2. 删除其中一个 set-url 地址

usage: git remote set-url [--push] <name> <newurl> [<oldurl>] or: git remote set-url --add <name> <newurl> or: git remote set-url --delete <name> <url>

git remote set-url --delete origin https://oschina.net/wang/JSLite.js.git

3. 推送代码

git push origin master git push -f origin master # 强制推送

4. 拉代码

只能拉取origin里的一个 url 地址，这个 fetch-url 默认为你添加到origin的第一个地址：

git pull origin master git pull --all # 获取远程所有内容包括 tag git pull origin next:master # 取回 origin 主机的 next 分支，与本地的 master 分支合并 git pull origin next # 远程分支是与当前分支合并 # 上面一条命令等同于下面两条命令 git fetch origin git merge origin/next

如果远程主机删除了某个分支，默认情况下 git pull 不会在拉取远程分支时删除对应的本地分支——这是为了防止其他人操作远程主机导致本地分支被不知不觉删除。但可以加上参数-p，在本地删除远程已经删除的分支：

git pull -p # 等同于下面的命令 git fetch --prune origin git fetch -p

5. 更改 pull

只需要更改 config 文件里那三个 url 的顺序即可，fetch-url 会直接对应排行第一的那个 url 连接。

修改远程仓库地址

git remote remove origin # 删除该远程路径 git remote add origin git@jslite.github.com:JSLite/JSLite.git # 添加远程路径

撤销远程记录

git reset --hard HEAD~1 # 撤销一条记录 git push -f origin HEAD:master # 同步到远程仓库

放弃本地的文件修改

git reset --hard FETCH_HEAD # FETCH_HEAD 表示上一次成功 git pull 之后形成的 commit 点。然后 git pull

如果执行git reset --hard FETCH_HEAD出现错误：

git pull You are not currently on a branch, so I cannot use any 'branch.<branchname>.merge' in your configuration file. Please specify which remote branch you want to use on the command line and try again (e.g. 'git pull <repository> <refspec>'). See git-pull(1) FOR details.

解决方法：

git checkout -b temp # 新建+切换到 temp 分支 git checkout master

最简单放弃本地修改内容

# 如果有的修改已经加入暂存区的话 git reset --hard # 还原所有修改，不会删除新增的文件 git checkout . # 下面命令会删除新增的文件 git clean -xdf

通过存储暂存区 stash，再删除暂存区的方法也可以放弃本地修改：

git stash && git stash drop

回滚到某个 commit 提交

git revert HEAD~1 # 撤销一条记录，会弹出 commit 编辑 git push # 提交回滚

回退到某一个版本

git reset --hard <hash> # 例如 git reset --hard a3hd73r # --hard 代表丢弃工作区的修改，让工作区与版本代码一模一样，与之对应， # --soft 参数代表保留工作区的修改。

去掉某个 commit

# 实质是新建了一个与原来完全相反的 commit，抵消了原来 commit 的效果 git revert <commit-hash>

新建一个空分支

# 这种方式新建的分支(gh-pages)是没有 commit 记录的 git checkout --orphan gh-pages # 删除新建的 gh-pages 分支原本的内容，如果不删除，提交将作为当前分支的第一个 commit git rm -rf . # 查看一下状态 有可能上面一条命令，没有删除还没有提交的文件 git status

合并多个 commit

# 这个命令，将最近 4 个 commit 合并为 1 个，HEAD 代表当前版本。 # 将进入 VIM 界面，你可以修改提交信息。 git rebase -i HEAD~4 # 可以看到其中分为两个部分，上方未注释的部分是填写要执行的指令， # 而下方注释的部分则是指令的提示说明。指令部分中由前方的命令名称、commit hash 和 commit message 组成 # 当前我们只要知道 pick 和 squash 这两个命令即可。 # --> pick 的意思是要会执行这个 commit # --> squash 的意思是这个 commit 会被合并到前一个 commit # 我们将需要保留的这个 commit 前方的命令改成 squash 或 s，然后输入 :wq 以保存并退出 # 这时我们会看到 commit message 的编辑界面 # 其中非注释部分就是两次的 commit message，你要做的就是将这两个修改成新的 commit message。 # 输入 wq 保存并退出，再次输入 git log 查看 commit 历史信息，你会发现这两个 commit 已经合并了。 # 将修改强制推送到前端 git push -f origin master

修改远程 Commit 记录

git commit --amend # amend 只能修改没有提交到线上的最后一次 commit 记录 git rebase -i HEAD~3 # 表示要修改当前版本的倒数第三次状态 # 将要更改的记录行首单词 pick 改为 edit pick 96dc3f9 doc: Update quick-start.md pick f1cce8a test(Transition):Add transition test (#47) pick 6293516 feat(Divider): Add Divider component. # Rebase eeb03a4..6293516 onto eeb03a4 (3 commands) # # Commands: # p, pick = use commit # r, reword = use commit, but edit the commit message # e, edit = use commit, but stop for amending # s, squash = use commit, but meld into previous commit # f, fixup = like "squash", but discard this commit's log message # x, exec = run command (the rest of the line) using shell # d, drop = remove commit

保存并退出，会弹出下面提示：

# You can amend the commit now, with # # git commit --amend # # Once you are satisfied with your changes, run # # git rebase --continue # 通过这条命令进入编辑页面更改 commit，保存退出 git commit --amend # 保存退出确认修改，继续执行 rebase git rebase --continue # 如果修改多条记录反复执行上面两条命令直到完成所有修改 # 最后，确保别人没有提交进行 push，最好不要加 -f 强制推送 git push -f origin master

添加忽略文件

echo node_modules/ >> .gitignore

利用 commit 关闭一个 issue

这个功能在 GitHub 上可以玩，GitLab 特别老的版本不能玩。如何在 commit 时关闭相关 issue 呢？在 confirm merge 的时候可以使用如下命令来关闭相关 issue：

fixes #xxx、fixed #xxx、fix #xxx、closes #xxx、close #xxx、closed #xxx

也可以在任意位置带上#符号加上 issue 号码，如git commit -m "#133"关联 issue，git commit -m "fix #133"提交时关闭 issue。

同步 fork 的上游仓库

设置添加多个远程仓库地址

在同步之前，需要创建一个远程点指向上游仓库（repo）。如果你已经 fork 了一个原始仓库，可以按照如下方法做：

$ git remote -v # List the current remotes （列出当前远程仓库） # origin https://github.com/user/repo.git (fetch) # origin https://github.com/user/repo.git (push) $ git remote add upstream https://github.com/otheruser/repo.git # Set a new remote (设置一个新的远程仓库) $ git remote -v # Verify new remote (验证新的远程仓库) # origin https://github.com/user/repo.git (fetch) # origin https://github.com/user/repo.git (push) # upstream https://github.com/otheruser/repo.git (fetch) # upstream https://github.com/otheruser/repo.git (push)

同步更新仓库内容

同步上游仓库到你的仓库需要执行两步：首先你需要从远程拉取，之后你需要合并你希望的分支到你的本地副本分支。从上游的存储库中提取分支以及各自的提交内容，master将被存储在本地分支upstream/master：

git fetch upstream # remote: Counting objects: 75, done. # remote: Compressing objects: 100% (53/53), done. # remote: Total 62 (delta 27), reused 44 (delta 9) # Unpacking objects: 100% (62/62), done. # From https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY # * [new branch] master -> upstream/master

检查你的 fork 的本地master分支：

git checkout master # Switched to branch 'master'

合并来自upstream/master的更改到本地 master 分支上，这使你的 fork 的master分支与上游资源库同步，而不会丢失你本地修改：

git merge upstream/master # Updating a422352..5fdff0f # Fast-forward # README | 9 ------- # README.md | 7 ++++++ # 2 files changed, 7 insertions(+), 9 deletions(-) # delete mode 100644 README # create mode 100644 README.md

批量修改历史 commit 中的名字和邮箱

1. 克隆仓库

注意参数，这个不是普通的 clone，clone 下来的仓库并不能参与开发：

git clone --bare https://github.com/user/repo.git cd repo.git

2. 命令行中运行代码

其中OLD_EMAIL是原来的邮箱，CORRECT_NAME是更正的名字，CORRECT_EMAIL是更正的邮箱。将下面代码复制放到命令行中执行：

git filter-branch -f --env-filter ' OLD_EMAIL="old@example.com" CORRECT_NAME="Correct Name" CORRECT_EMAIL="correct@example.com" if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ] then export GIT_COMMITTER_NAME="$CORRECT_NAME" export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL" fi if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ] then export GIT_AUTHOR_NAME="$CORRECT_NAME" export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL" fi ' --tag-name-filter cat -- --branches --tags

执行过程示例：

Rewrite 160d4df2689ff6df3820563bfd13b5f1fb9ba832 (479/508) (16 seconds passed, remaining 0 predicted) Ref 'refs/heads/dev' was rewritten Ref 'refs/heads/master' was rewritten

3. 同步到远程仓库

git push --force --tags origin 'refs/heads/*'

如果遇到下面错误，是 GitLab 默认给 master 分支加了保护，不允许强制覆盖。需要在Project(项目)→Setting→Repository菜单下面的Protected branches把 master 的保护去掉。修改完之后建议把 master 的保护再加回来，毕竟强推不是件好事：

remote: GitLab: You are not allowed to force push code to a protected branch on this project.

当上面的 push 不上去的时候，先git pull确保最新代码：

git pull --allow-unrelated-histories # 或者指定分支 git pull origin master --allow-unrelated-histories

查看某个文件历史

git log --pretty=oneline 文件名 # 列出文件的所有改动历史 git show c178bf49 # 某次的改动的修改记录 git log -p c178bf49 # 某次的改动的修改记录 git blame 文件名 # 显示文件的每一行是在那个版本最后修改 git whatchanged 文件名 # 显示某个文件的每个版本提交信息：提交日期，提交人员，版本号，提交备注（没有修改细节）

新建仓库

init

git init # 初始化

status

git status # 获取状态

add

git add file # . 或 * 代表全部添加 git rm --cached <added_file_to_undo> # 在 commit 之前撤销 git add 操作 git reset head # 好像比上面 `git rm --cached` 更方便

commit

git commit -m "message" # 此处注意乱码

remote

git remote add origin git@github.com:JSLite/test.git # 添加源

push

git push -u origin master # push 同时设置默认跟踪分支 git push origin master git push -f origin master # 强制推送文件，缩写 -f（全写 --force）

clone 多协议克隆

git clone git://github.com/JSLite/JSLite.js.git git clone git://github.com/JSLite/JSLite.js.git mypro # 克隆到自定义文件夹 git clone [user@]example.com:path/to/repo.git/ # SSH 协议还有另一种写法

git clone 支持多种协议，除了 HTTP(s) 以外，还支持 SSH、Git、本地文件协议等，格式为git clone <版本库的网址> <本地目录名>：

git clone http[s]://example.com/path/to/repo.git/ git clone ssh://example.com/path/to/repo.git/ git clone git://example.com/path/to/repo.git/ git clone /opt/git/project.git git clone file:///opt/git/project.git git clone ftp[s]://example.com/path/to/repo.git/ git clone rsync://example.com/path/to/repo.git/

本地操作

help

git help config # 获取帮助信息

add

git add * # 跟踪新文件 git add -u [path] # 添加[指定路径下]已跟踪文件

rm

rm * && git rm * # 移除文件 git rm -f * # 移除文件 git rm --cached * # 取消跟踪 git mv file_from file_to # 重命名跟踪文件 git log # 查看提交记录

commit

git commit # 提交更新 git commit -m 'message' # 提交说明 git commit -a # 跳过使用暂存区域，把所有已经跟踪过的文件暂存起来一并提交 git commit --amend # 修改最后一次提交 git commit log # 查看所有提交，包括没有 push 的 commit git commit -m "#133" # 关联 issue，任意位置带上 # 符号加上 issue 号码 git commit -m "fix #133" # commit 关闭 issue git commit -m '概要描述'$'\n\n''1.详细描述'$'\n''2.详细描述' # 提交简要描述和详细描述

reset

git reset HEAD * # 取消已经暂存的文件 git reset --mixed HEAD * # 同上 git reset --soft HEAD * # 重置到指定状态，不会修改索引区和工作树 git reset --hard HEAD * # 重置到指定状态，会修改索引区和工作树 git reset -- files * # 重置 index 区文件

revert

git revert HEAD # 撤销前一次操作 git revert HEAD~ # 撤销前前一次操作 git revert commit # 撤销指定操作

checkout

git checkout -- file # 取消对文件的修改（从暂存区覆盖 worktree file） git checkout branch|tag|commit -- file_name # 从仓库取出 file 覆盖当前分支 git checkout HEAD~1 [文件] # 将会更新 working directory 去匹配某次 commit git checkout -- . # 从暂存区取出文件覆盖工作区 git checkout -b gh-pages 0c304c9 # 这个表示从当前分支 commit 哈希值为 0c304c9 的节点，分一个新的分支 gh-pages 出来，并切换到 gh-pages

diff

git diff file # 查看指定文件的差异 git diff --stat # 查看简单的 diff 结果 git diff # 比较 Worktree 和 Index 之间的差异 git diff --cached # 比较 Index 和 HEAD 之间的差异 git diff HEAD # 比较 Worktree 和 HEAD 之间的差异 git diff branch # 比较 Worktree 和 branch 之间的差异 git diff branch1 branch2 # 比较两次分支之间的差异 git diff commit commit # 比较两次提交之间的差异 git diff master..test # 上面这条命令只显示两个分支间的差异 git diff master...test # 找出 master、test 的共有父分支和 test 分支之间的差异，用 3 个 '.' 来取代前面的两个 '.'

stash

git stash # 将工作区现场（已跟踪文件）储藏起来，等以后恢复后继续工作 git stash list # 查看保存的工作现场 git stash apply # 恢复工作现场 git stash drop # 删除 stash 内容 git stash pop # 恢复的同时直接删除 stash 内容 git stash apply stash@{0} # 恢复指定的工作现场，当你保存了不只一份工作现场时

merge

git merge --squash test # 合并压缩，将 test 上的 commit 压缩为一条

cherry-pick

git cherry-pick commit # 拣选合并，将 commit 合并到当前分支 git cherry-pick -n commit # 拣选多个提交，合并完后可以继续拣选下一个提交

rebase

git rebase master # 将 master 分支上超前的提交，变基到当前分支 git rebase --onto master 169a6 # 限制回滚范围，rebase 当前分支从 169a6 以后的提交 git rebase --interactive # 交互模式，修改 commit git rebase --continue # 处理完冲突继续合并 git rebase --skip # 跳过 git rebase --abort # 取消合并

分支 branch

删除

git push origin :branchName # 删除远程分支 git push origin --delete new # 删除远程分支 new git branch -d branchName # 删除本地分支，强制删除用 -D git branch -d test # 删除本地 test 分支 git branch -D test # 强制删除本地 test 分支 git remote prune origin # 远程删除了，本地还能看到远程存在，这条命令删除远程不存在的分支

提交

git push -u origin branchName # 提交分支到远程 origin 主机中

拉取

git fetch -p # 拉取远程分支时，自动清理远程分支已删除、本地还存在的对应同名分支

分支合并

git merge branchName # 合并分支 - 将分支 branchName 和当前所在分支合并 git merge origin/master # 在本地分支上合并远程分支 git rebase origin/master # 在本地分支上合并远程分支 git merge test # 将 test 分支合并到当前分支

重命名

git branch -m old new # 重命名分支

查看

git branch # 列出本地分支 git branch -r # 列出远端分支 git branch -a # 列出所有分支 git branch -v # 查看各个分支最后一个提交对象的信息 git branch --merge # 查看已经合并到当前分支的分支 git branch --no-merge # 查看未合并到当前分支的分支 git remote show origin # 可以查看 remote 地址、远程分支

新建

git branch test # 新建 test 分支 git branch newBrach 3defc69 # 指定哈希 3defc69，新建分支名字为 newBrach git checkout -b newBrach origin/master # 取回远程主机的更新以后，在它的基础上创建一个新的分支 git checkout -b newBrach 3defc69 # 以哈希值 3defc69 新建 newBrach 分支，并切换到该分支

连接

git branch --set-upstream dev origin/dev # 将本地 dev 分支与远程 dev 分支之间建立链接 git branch --set-upstream master origin/next # 手动建立追踪关系

分支切换

git checkout test # 切换到 test 分支 git checkout -b test # 新建+切换到 test 分支 git checkout -b test dev # 基于 dev 新建 test 分支，并切换

远端

git fetch <远程主机名> <分支名> # fetch 取回所有分支（branch）的更新 git fetch origin remotebranch[:localbranch] # 从远端拉取分支[到本地指定分支] git merge origin/branch # 合并远端上指定分支 git pull origin remotebranch:localbranch # 拉取远端分支到本地分支 git push origin branch # 将当前分支，推送到远端上指定分支 git push origin localbranch:remotebranch # 推送本地指定分支，到远端上指定分支 git push origin :remotebranch # 删除远端指定分支 git checkout -b [--track] test origin/dev # 基于远端 dev 分支，新建本地 test 分支[同时设置跟踪]

submodule

克隆项目同时克隆 submodule：

git clone https://github.com/jaywcjlove/handbook.git --depth=1 --recurse-submodules

克隆项目之后再手动克隆 submodule 子项目：

git submodule add --force '仓库地址' '路径' # 其中，仓库地址是指子模块仓库地址，路径指将子模块放置在当前工程下的路径。 # 注意：路径不能以 / 结尾（会造成修改不生效）、不能是现有工程已有的目录（不能顺利 Clone） git submodule init # 初始化 submodule git submodule update # 更新 submodule（必须在根目录执行命令） git submodule update --init --recursive # 下载的工程带有 submodule

当使用git clone下来的工程中带有 submodule 时，初始的时候 submodule 的内容并不会自动下载下来，此时只需执行如下命令：

git submodule foreach git pull # submodule 里有其他的 submodule 一次更新 git submodule foreach git pull origin master # submodule 更新 git submodule foreach --recursive git submodule init git submodule foreach --recursive git submodule update

删除文件

git rm -rf node_modules/

remote 多源管理

git 是一个分布式代码管理工具，所以可以支持多个仓库，在 git 里，服务器上的仓库在本地称之为 remote：

git remote add origin1 git@github.com:yanhaijing/data.js.git git remote # 显示全部源 git remote -v # 显示全部源+详细信息 git remote rename origin1 origin2 # 重命名 git remote rm origin # 删除 git remote show origin # 查看指定源的全部信息

标签 tag

当开发到一定阶段时，给程序打标签是非常棒的功能：

git tag -a v0.1 -m 'my version 1.4' # 新建带注释标签 git push origin --tags # 一次性推送所有分支 git push origin v1.5 # 推送单个 tag 到 origin 源上 git tag -v v1.4.2.1 # 验证标签，验证已经签署的标签 git show v1.5 # 看到对应的 GPG 签名 git tag # 列出现有标签 git tag v0.1 # 新建标签 git checkout tagname # 切换到标签 git tag -d v0.1 # 删除标签 git push origin :refs/tags/v0.1 # 删除远程标签 git pull --all # 获取远程所有内容包括 tag git --git-dir='<绝对地址>/.git' describe --tags HEAD # 查看本地版本信息

日志 log

git config format.pretty oneline # 显示历史记录时，每个提交的信息只显示一行 git config color.ui true # 彩色的 git 输出 git log # 查看提交日志，从最近的提交开始显示 git log --reverse # 查看提交日志，从最远的提交开始显示 git log --pretty=oneline # 单行显示提交日志 git log --graph --pretty=oneline --abbrev-commit git log -num # 显示第几条 log（倒数） git reflog # 查看所有分支的所有操作记录 git log --since=1.day # 一天内的提交；你可以给出各种时间格式，比如说具体的某一天（"2008-01-15"），或者是多久以前（"2 years 1 day 3 minutes ago"） git log --pretty="%h - %s" --author=自己的名字 # 查看自己的日志 git log -p -2 # 展开两次更新显示每次提交的内容差异 git log --stat # 要快速浏览其他协作者提交的更新都作了哪些改动 git log --pretty=format:"%h - %an, %ar : %s" # 定制要显示的记录格式 git log --pretty=format:'%h : %s' --date-order --graph # 拓扑顺序展示 git log --pretty=format:'%h : %s - %ad' --date=short # 日期 YYYY-MM-DD 显示 git log <last tag> HEAD --pretty=format:%s # 只显示 commit git config --global format.pretty '%h : %s - %ad' --date=short # 日期 YYYY-MM-DD 显示，写入全局配置

git log --pretty=format支持的常用占位符：

重写历史

git commit --amend # 改变最近一次提交 git rebase -i HEAD~3 # 修改最近三次的提交说明，或者其中任意一次 git commit --amend # 保存好了，这些指示很明确地告诉了你该干什么 git rebase --continue # 修改提交说明，退出编辑器

例如把下面三个提交：

pick f7f3f6d changed my name a bit pick 310154e updated README formatting and added blame pick a5f4a0d added cat-file

改成（调整顺序或删除）：

pick 310154e updated README formatting and added blame pick f7f3f6d changed my name a bit

删除仓库

cd .. rm -rf repo.git

其它实用命令

git help * # 获取命令的帮助信息 git status # 获取当前的状态，非常有用，因为 git 会提示接下来的能做的操作

报错问题解决

1.git fatal: protocol error: bad line length character: No s

解决办法：更换 remote 地址为http/https的。

2.The requested URL returned error: 403 Forbidden while accessing

解决 github push 错误的办法：

# vim 编辑器打开当前项目中的 config 文件 vim .git/config # 修改 [remote "origin"] url = https://github.com/jaywcjlove/example.git # 为下面代码 [remote "origin"] url = https://jaywcjlove@github.com/jaywcjlove/example.git

3. git status 显示中文问题

在查看状态的时候 git status 如果是中文就显示下面的情况：

\344\272\247\345\223\201\351\234\200\346\261\202

解决这个问题方法是：

git config --global core.quotepath false

在 linux-command 项目中的定位与延伸

本仓库（linux-command）搜集了 600 多个 Linux 命令，git被归入「文件管理」命令分类（见 README.md 的 Linux 命令分类章节），与 diff、find、ln、mv、rm 等命令并列。所有命令文档以 Markdown 形式存放在 command 目录中（git 文档即 command/git.md），构建阶段由npm run build（见 package.json 中的 scripts 配置）统一处理，通过 template/details.ejs 将 Markdown 渲染为 HTML 详情页；scripts/dash.mjs 还会把全部命令文档打包成 Dash/Zeal 可用的.docset文档集，便于离线查询。也就是说，本文讲解的每一条命令，都可以在仓库中对应 command/git.md 原文找到完整出处，并可通过npm install linux-command安装后在本地以 Markdown 形式引用查阅。

作为一份面向实战的速查手册，建议把文中「配置 → clone → add/commit → push → branch/merge → tag → log → 回滚/撤销」这条主线串联练习一遍，再针对多账号 SSH、多源推送、历史重写等进阶场景按需查阅，即可覆盖绝大多数日常与协作开发需求。

• 文档
• 教程