Tig 终端 Git 浏览器使用指南

Tig 终端 Git 浏览器使用指南

tig Text-mode interface for git 项目地址: https://gitcode.com/gh_mirrors/ti/tig

项目概述

Tig 是一个基于 ncurses 的文本模式 Git 仓库浏览器，它为用户提供了浏览 Git 仓库变更的直观界面。作为 Git 的补充工具，Tig 不仅能浏览仓库历史，还能作为 Git 命令输出的分页器，对输出内容进行着色处理。

核心功能

1. 基本使用模式

Tig 提供两种主要使用模式：

1. 仓库浏览模式：默认模式，提供丰富的仓库历史浏览功能
2. 分页模式：当通过管道接收输入时，自动作为分页器使用，对 Git 命令输出进行着色

2. 视图系统

Tig 的核心是其多视图系统，每种视图专注于展示特定类型的 Git 信息：

| 视图名称 | 功能描述 | |---------|----------| | 主视图 | 显示提交的单行摘要，包括日期、作者和提交信息首行 | | 日志视图 | 显示完整提交信息和变更统计 | | 引用日志视图 | 显示仓库的引用日志历史 | | 差异视图 | 显示工作区变更或提交的完整差异 | | 树视图 | 浏览当前版本的目录结构 | | 文件视图 | 查看文件内容 | | 追溯视图 | 显示文件的逐行修改历史 | | 引用视图 | 显示分支、远程和标签 | | 状态视图 | 管理工作区文件状态 | | 暂存视图 | 查看和管理暂存区变更 |

高级功能

1. 状态变量系统

Tig 维护了一套丰富的状态变量，可以在自定义命令中使用：

# 示例：修改最近提交
bind generic + !git commit --amend

# 示例：将当前提交ID复制到剪贴板
bind generic 9 @sh -c "echo -n %(commit) | xclip -selection c"

常用状态变量包括：

• %(commit)：当前选中提交ID
• %(file)：当前选中文件
• %(branch)：当前分支名
• %(repo:head)：检出分支名

2. 环境配置

通过环境变量可定制 Tig 行为：

# 设置差异显示选项
export TIG_DIFF_OPTS="--relative-date"

# 限制显示的引用范围
export TIG_LS_REMOTE="git ls-remote . master feature/*"

操作指南

1. 视图操作

| 快捷键 | 功能 | |--------|------| | m | 切换到主视图 | | d | 切换到差异视图 | | t | 切换到树视图 | | b | 切换到追溯视图 | | Enter | 根据上下文执行操作（如查看提交差异） | | Tab | 在分割视图中切换焦点 |

2. 导航控制

| 快捷键 | 功能 | |--------|------| | j/k | 上下移动光标 | | PgUp/PgDn | 翻页浏览 | | Home/End | 跳转到首尾 |

3. 搜索功能

• /：向前搜索
• ?：向后搜索
• n/N：查找下一个/上一个匹配项

支持 POSIX 扩展正则表达式，如果编译时启用了 PCRE 支持，还可使用 Perl 兼容正则表达式。

配置管理

Tig 按以下顺序读取配置文件：

1. 系统级配置文件（默认路径为 /etc/tigrc）
2. 用户级配置文件（默认为 ~/.tigrc 或 $XDG_CONFIG_HOME/tig/config）

可通过环境变量覆盖默认路径：

• TIGRC_USER：用户配置文件路径
• TIGRC_SYSTEM：系统配置文件路径

实用技巧

1. 快速查看变更：在状态视图中使用 u 键可以暂存/取消暂存文件变更
2. 差异上下文控制：使用 [ 和 ] 调整差异显示的上下文行数
3. 图形化显示：使用 G 键切换提交历史图形显示
4. 忽略空白变更：使用 W 键切换是否忽略空白字符变更

Tig 作为 Git 的终端界面补充，特别适合习惯命令行操作但又需要更直观浏览历史的开发者。通过熟练掌握其多视图系统和快捷键，可以显著提升 Git 仓库的浏览和管理效率。

tig Text-mode interface for git 项目地址: https://gitcode.com/gh_mirrors/ti/tig