Git 是目前世界上最先进的分布式版本控制系统。虽然命令行（CLI）功能强大，但对于大多数开发者来说，命令繁多且难以记忆。

TortoiseGit（简称 tgit，中文名海龟 Git）是一个开放的 Git 版本控制系统的源客户端，提供图形化界面（GUI），通过右键菜单即可完成 Git 操作，极大地简化了版本控制流程。

如果需要学习 Git命令行的使用，请参考《Git 教程 - 菜鸟教程》。

第一部分：下载与安装

环境安装需要按顺序进行：先安装 Git，再安装 TortoiseGit，最后安装语言包。

1. 下载安装 Git

2. 下载安装 TortoiseGit 及中文包

第二部分：初始配置

安装完成后，必须进行配置才能正常使用

1. 语言与基础设置

在任意文件夹空白处点击鼠标右键，选择 TortoiseGit --> Settings。

  • 设置中文：选中 General，在右边的 Language 中选择“简体中文”。

  • 指定 Git 路径：通常会自动识别，如果没有，需手动指定 git.exe 路径（如 D:\Program Files\Git\bin）。

2. 配置用户身份 (User Info)

点击左侧 Git 标签。这是你提交代码时的“签名”，必须配置。

  • Name：输入你的名字。
  • Email：输入你的邮箱。

3. 配置凭证（记住密码）

为了避免每次使用 HTTPS 推送代码时都输入密码，可以点击上图中的 “编辑全局 .git/config(O)”，在文件末尾添加以下内容并保存：

1
2
[credential]
  helper = store

这样，第一次输入密码后，Git 就会自动记住。

4. 配置 SSH Key（推荐）

如果你希望使用 SSH 方式（免密且安全）连接 GitHub 或其他 Git 服务器，需进行以下配置：

  1. 生成 Key：在文件夹右键选择 Git GUI Here -> Help -> Show SSH Key。如果没有，点击 Generate Key 生成。

  2. 获取公钥：复制生成的全部内容（通常在 C:\Users\用户名\.ssh\id_rsa.pub）。

  3. 添加到服务器：

    • GitHub：头像 -> Settings -> SSH and GPG Keys -> New SSH Key -> 粘贴。

第三部分：创建与克隆仓库

方式一：克隆远程项目 (Git Clone)

这是最常用的方式，将远程服务器（如 GitHub、Gitee）上的代码下载到本地。

  1. 获取地址：在代码托管平台复制项目的 URL（HTTPS 或 SSH）。
  2. 克隆：在本地空白文件夹右键 -> Git Clone (Git 克隆)。
  3. 确认：URL 会自动填充，确认目录无误后点击 OK。

方式二：本地初始化 (Git Init)

如果你是从零开始写项目，没有远程仓库：

  1. 新建一个文件夹（如 git_demo）。
  2. 右键 -> Git Create repository here。
  3. 这会自动生成一个隐藏的 .git 目录，该文件夹即变为 Git 仓库。

第四部分：日常工作流

1. 识别文件状态（图标说明）

TortoiseGit 通过图标让文件状态一目了然：

  • 绿色对号：正常，未修改。
  • 红色感叹号：文件被修改过，尚未提交。
  • 蓝色加号：新添加的文件。
  • 黄色感叹号：有冲突，需要解决。

2. 提交代码 (Commit)

将本地的修改保存到本地版本库。

  1. 在仓库目录右键 -> Git Commit (Master)。
  2. 填写日志信息 (Message)，勾选要提交的文件。
  3. 点击 Commit。

3. 推送代码 (Push)

将本地库的提交上传到远程服务器。

  1. 右键 -> TortoiseGit -> Push。
  2. 点击确定。

4. 拉取代码 (Pull)

从远程服务器获取最新的代码并合并到本地。建议在每天工作开始前或 Push 之前先 Pull 一下。

  1. 右键 -> TortoiseGit -> Pull。

第五部分：进阶操作

1. 查看与修改日志 (Show Log)

想看项目历史记录或回退？

  • 右键 -> TortoiseGit -> Show log。

2. 版本回滚 (Reset)

如果代码改乱了，想回到过去的某个版本：

  1. 在日志界面 (Show log) 找到想要回到的那条记录。
  2. 右键点击该记录 -> Reset "master" to this。
  3. Hard 模式会丢弃所有未提交的修改，Soft 模式会保留修改在暂存区。

3. 创建与切换分支 (Branch)

  1. 创建：右键 -> TortoiseGit -> Create Branch，输入分支名（如 b01）。
  2. 切换：右键 -> TortoiseGit -> Switch/Checkout，选择要切换的分支。

4. 忽略文件 (Ignore)

有些文件（如编译生成的临时文件）不需要上传：

  1. 选中该文件 -> 右键 -> TortoiseGit -> Delete and add to ignore list。
  2. 这会自动生成或更新 .gitignore 文件。

5. 解决冲突 (Resolve Conflicts)

当多人同时修改同一个文件的同一行时，Pull 代码会产生冲突。

  1. 冲突文件会显示黄色感叹号图标。
  2. 右键点击冲突文件 -> TortoiseGit -> Edit conflicts。
  3. 界面会显示 Theirs（远程代码）、Mine（我的代码）和 Merged（合并结果）。
  4. 手动调整 Merged 窗口的内容，保留需要的代码。
  5. 完成后点击 Mark as resolved（标记为已解决），然后重新 Commit 和 Push。

6. 配置比较工具 (Beyond Compare)

TortoiseGit 自带的比较工具功能有限，建议配置专业的 Beyond Compare。

  • 在 Settings -> Diff Viewer 中，选择 External，并指定 Beyond Compare 的 BCompare.exe 路径。

此教程引用文章：
TortoiseGit 使用教程- 啊，那一个人
TortoiseGit-使用教程（图文详细版） - R-Bear
TortoiseGit 官方文档

许可协议

本文采用 署名-非商业性使用-相同方式共享 4.0 国际 许可协议，转载请注明出处。

分享文章

快来参与讨论吧~