From 694a38a8d0d7763341de84c62d097174567fc8b3 Mon Sep 17 00:00:00 2001 From: "rick.chan" Date: Thu, 10 Dec 2020 11:25:23 +0800 Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=20Tig=20=E4=BD=BF=E7=94=A8?= =?UTF-8?q?=E8=AF=B4=E6=98=8E.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: rick.chan --- Software/Applications/Git/Tig_使用说明.md | 46 +++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 Software/Applications/Git/Tig_使用说明.md diff --git a/Software/Applications/Git/Tig_使用说明.md b/Software/Applications/Git/Tig_使用说明.md new file mode 100644 index 0000000..447c7d1 --- /dev/null +++ b/Software/Applications/Git/Tig_使用说明.md @@ -0,0 +1,46 @@ +# Tig 使用说明 + +Tig 是一个文本模式 git 资源库浏览器，采用 ncurses 开发。 + +## 1.安装 + +```bash +# Ubuntu +apt-get install tig +# Manjaro/Arch Linux +pacman -S git +``` + +## 2.使用 + +在 Git 项目中敲 tig，进入 tig 界面后再敲 h (代表help) 即可进入帮助界面，该界面列出了所有常用命令。 + +项目分支下直接敲 tig，进入到了 log 界面，使用 j/k 或 上/下 键可以选择指定提交，回车后，界面的一半会展示此次commit详情，此时，上/下 键可以选择 log 中的 commit，详情界面会跟着变化，而 j/k 键会在 commit 详情内移动焦点。 + +选中 commit 中列出的文件，回车会跳转到该文件的详情，而使用 @ 可以按照代码块的粒度来浏览 commit 中的内容。 + +在使用 Git 命令的过程中，最高频的命令应该是 git status，主要用来查看 staged changes 和 unstaged changes。敲回车，详情界面展示出来后敲 u 会使整个 changes 由staged changes 变为 unstaged changes，或是由unstaged changes 变为 staged changes，如果想要 changes 中的某一个文件改变状态，则在详情界面选中该文件，回车，再敲 u ,即可使该文件由 staged 变为 unstaged，或是由 unstaged 变为 staged，如果你想重置某个文件的修改，选中该文件敲 ! 即可，再也不用使用 git reset HEAD这个命令了。 + +如果我还想看 untracked files 怎么办呢? tig 提供了一种更纯粹的查看 git status 的界面，进入 tig 后直接敲 s 即可，选中 untracked file 或 unstaged file，敲 u，即可变为 staged file，选中 staged file 敲 u 变为 unstaged file，如果你想重置某个文件未保存的修改，在该文件下敲 ! 即可，如果你准备好提交了，按下 shift + c 即可打开默认命令行编辑器来编辑 commit message，如果在 tig 主界面按下shift + c，将会使用 git cherry-pick 命令。 + +tig 也可以当做命令行版的 Finder 来使用，在 log 主界面敲 t (代表 tree) 即可进入此次 commit 中所有文件列表，在文件夹下回车可以进入文件夹，在文件下回车可以在界面的一半展示该文件的全貌(而不是此次 commit 的修改)。 + +如果选中文件，按 b 即可进入该文件的 blame 界面，在 blame 中选中任意一行回车，即可在界面的一半展示此次 commit 的所有内容，依然可以用 j/k 控制详情内容的单行移动，回车跳转到某文件，@按照代码块粒度滚动，这种操作比使用 git blame 方便了许多。 + +如何查看 diff 中某句修改时整个文件的面貌呢? 实际上在 diff 界面也可以直接敲 b 进入 blame 界面即可查看截止此次提交时该文件的全貌，如果明确知道想要看哪个文件的 blame 全貌，也可以 直接使用 tig blame filename。 + +如何查看一个文件的全部提交记录? 以及快速查看某次提交的全部内容? 有了 tig，可以轻松做到这一点，直接 tig filename，进入到该文件的 tig 主界面，即可快速查看指定文件的 log 和提交内容，你还可以选择只查看某个 commit 以及之前的提交，只需要使用 tig commit-id filename 即可。 + +如何查找 commit message 中带有指定文字的 commit 呢? 如果终端本身支持搜索功能，使用终端自带的 cmd + f 即可搜索 tig 主界面中的任何文本，那如何通过 commit-id 查找呢? tig 主界面中默认没有展示 commit-id，使用 shift + x 即可展示 commit-id。 + +tig 也自带搜索功能，敲 / 即可进入，输入字符后回车，将高亮展示所有匹配项，敲 n 将聚焦到离当前焦点最近的下方的匹配项，大写 N 则是上方的匹配项，敲回车将展示详情。 + +在提交 commit 中常常会碰到按代码块的粒度来提交的需求，使用原生的 git add -i 略显繁琐，在 tig 中，这个操作变得无比简单，只需要在 staged changes 或 unstaged changes 使用 @ 选中代码块，敲 u 即可改变状态，如果你只想改变一行代码的状态，使用 j/k 选中要改变的单行代码，用数字键 1 代替 u 即可实现这个原本用 Git 命令行很难实现的功能。 + +进入 tig 主界面敲 r 即可看到项目分支列表，在分支下敲回车即可进入 log 界面，使用这个功能可以快速在不同分支之间查阅代码，免去了频繁切换分支的麻烦，需要切换分支时，选中分支按住 shift + c 即可。 + +至此，我分享了一些日常使用频率很高，但使用 Git 命令来完成却很繁琐的 tig 使用攻略，文章最后，我想分享一个学习 Git 命令的捷径，我在学习 Git 的过程中，自己觉得还是走了一点弯路，如果你知道 oh-my-zsh 的 Git aliases，你就知道我在说什么了，这份 aliases 整理了所有常用和有用的 Git 命令，初学者通过它能避免冗长的 Git 命令打击热情，也可以避免在不实用的 Git 命令上多花时间，有经验的开发者可以通过它来查漏补缺，看看哪些看似无用的 Git 命令加参数后就变得无比实用。 + +如果在一个团队中推广这份 aliases，可以避免你在队友的电脑上习惯性敲自己编的 alias 无效的麻烦，如果你使用 Dash，可以直接搜索 Oh-My-Zsh Git 添加这份 aliases 文档。 + +按 q 退出当前页面。