TortoiseGit详解:安装、配置与日常操作 – wiki词典

TortoiseGit详解:安装、配置与日常操作

TortoiseGit是一款免费开源的Git客户端,专为Windows操作系统设计。它通过与Windows资源管理器无缝集成,将Git的强大功能融入到图形界面中,极大地简化了版本控制操作,让开发者能够更直观、高效地管理代码。本文将详细介绍TortoiseGit的安装、配置及日常使用流程。


一、TortoiseGit 安装

在安装TortoiseGit之前,确保您的系统满足以下先决条件:

1. 前提条件

  • Git for Windows: TortoiseGit并非独立的Git实现,它依赖于命令行版的Git for Windows。您需要从Git官方网站下载并安装Git for Windows。安装时,通常可以接受默认选项,但建议不要安装Git for Windows自带的“Windows Explorer integration”,因为TortoiseGit将接管这一功能。
  • 操作系统: TortoiseGit支持Windows 10及更高版本。对于Windows 7/8/8.1等旧版本,虽然某些旧版TortoiseGit可能兼容,但最新版本已不再支持。
  • Microsoft Visual C++ Redistributable: TortoiseGit需要安装最新的“Microsoft Visual C++ Redistributable 2015–2022”。
  • 管理员权限: 安装TortoiseGit需要管理员权限。

2. 下载 TortoiseGit

  1. 访问TortoiseGit的官方下载页面
  2. 根据您的系统架构(32位、64位或ARM64)下载对应的安装程序。务必选择正确的版本以避免安装失败。

3. 安装步骤

  1. 找到下载的TortoiseGit安装文件,双击运行以启动安装向导。
  2. 按照安装向导的指示进行操作。通常情况下,您可以接受默认设置。
  3. 指定Git路径: 安装过程中,TortoiseGit会要求您提供Git可执行文件(git.exe)的路径。如果之前已安装Git for Windows,安装程序通常会自动检测到。否则,您可能需要手动浏览到其位置(例如:C:\Program Files\Git\bin\git.exe)。
  4. 选择您的SSH客户端。默认情况下,TortoiseGit使用TortoiseGitPlink,但如果您更喜欢OpenSSH,也可以配置使用ssh.exe
  5. 完成安装。您可能会收到提示,要求重启系统,以便更改完全生效,并且TortoiseGit的右键上下文菜单选项能够显示在Windows资源管理器中。

4. 安装语言包 (可选)

如果您希望使用非英文的TortoiseGit界面:

  1. 访问TortoiseGit下载页面,找到“Language Packs”部分。
  2. 下载所需语言的.msi安装包。
  3. 在完成主程序安装后,运行语言包安装程序。
  4. 安装完成后,您可以在TortoiseGit的设置对话框中选择相应的语言。

二、TortoiseGit 配置

安装完成后,建议进行一些基本的配置以确保TortoiseGit正常工作并提高使用体验。

1. 初始配置

  1. 用户信息:

    • 在桌面上或任意文件夹中右键单击,选择 TortoiseGit > Settings
    • 在设置对话框中,导航到左侧的 Git 部分。
    • 输入您的 Name (用户名)Email (电子邮件地址)。这些信息将用于标识您的Git提交。
  2. SSH 密钥生成与配置 (用于安全连接):

    • 如果您计划使用SSH协议与Git仓库进行身份验证(例如:GitHub、GitLab等),需要生成SSH密钥对。
    • 生成SSH密钥对:
      • 从右键上下文菜单中打开 TortoiseGit > PuTTYgen
      • 点击 Generate,并在窗口中移动鼠标以生成随机性。
      • (可选)为密钥设置一个 Key passphrase 以增加安全性。
      • 复制生成的公钥。您需要将此公钥添加到您的Git托管服务(例如:GitHub、GitLab、Bitbucket)中。
      • 点击 Save private key,并将其保存为.ppk文件,放在安全的位置。
    • 配置TortoiseGit使用SSH客户端:
      • 前往 TortoiseGit > Settings > Network
      • 确保 SSH client 设置为 TortoiseGitPlink.exe(TortoiseGit推荐)或 ssh.exe(如果您偏好OpenSSH)。如果使用TortoiseGitPlink.exe,它应与pagent.exe在同一文件夹中。

三、TortoiseGit 日常操作

TortoiseGit通过Windows资源管理器的右键菜单提供所有Git功能。以下是日常开发中常见的Git操作流程:

1. 克隆(Clone)仓库

  • 在您希望存放本地仓库的目录中,右键单击空白处。
  • 选择 Git Clone…
  • 在弹出的对话框中,输入远程Git仓库的URL,并确认本地路径。
  • 点击 OK,TortoiseGit将下载仓库内容并创建本地工作副本。

2. 进行更改与查看状态

  • 像往常一样编辑本地工作目录中的文件。
  • TortoiseGit会使用图标叠加(icon overlays)来显示文件的Git状态(例如:已修改、已添加、未版本控制)。绿色表示未修改,红色表示已修改,蓝色问号表示未跟踪等。

3. 添加(Add)更改到暂存区

  • 右键单击已修改的文件或整个仓库文件夹。
  • 选择 TortoiseGit > Add…
  • 在弹出的对话框中,选择您希望添加到暂存区的更改。这会将更改标记为待提交。

4. 提交(Commit)更改

  • 右键单击已修改的文件或仓库文件夹。
  • 选择 Git Commit -> “您的分支名称”…
  • 在提交对话框中,填写清晰的提交信息(Commit Message),描述本次更改的内容。
  • 选择要提交的文件。
  • 点击 OK 将更改提交到您的本地仓库。

5. 推送(Push)更改

  • 在提交更改后,您需要将本地提交推送到远程仓库。
  • 右键单击仓库文件夹,选择 TortoiseGit > Push…
  • 确认远程分支和本地分支的对应关系。
  • 点击 OK 将本地提交上传到远程仓库。

6. 拉取(Pull)/获取(Fetch)远程更改

  • 为了同步远程仓库的最新更改:
    • 右键单击本地仓库文件夹,选择 TortoiseGit > Pull。这将获取远程更改并尝试自动合并到当前分支。
    • 或者,选择 TortoiseGit > Fetch。Fetch只会下载远程更改到本地,而不会自动合并,这允许您在合并前先查看更改。

7. 创建与切换分支

  • 创建分支:
    • 右键单击仓库文件夹,选择 TortoiseGit > Create Branch…
    • 为新分支输入一个名称。
    • 点击 OK 创建分支。
  • 切换分支:
    • 右键单击仓库文件夹,选择 TortoiseGit > Switch/Checkout…
    • 从列表中选择您想要切换到的分支。
    • 点击 OK 切换到指定分支。

8. 解决冲突(Resolve Conflicts)

  • 如果在执行 PullMerge 操作时发生冲突(当您的本地更改与远程更改在同一行或附近发生冲突时),TortoiseGit会以红色图标标识冲突文件。
  • 右键单击冲突文件,选择 TortoiseGit > Resolve conflict。这将打开一个合并工具,允许您手动解决冲突。解决冲突后,保存文件并标记为已解决。

9. 查看日志/历史(Show Log)

  • 右键单击仓库文件夹,选择 TortoiseGit > Show Log
  • 这将打开一个图形化的日志查看器,您可以直观地查看提交历史、分支结构和合并记录。

10. 暂存更改(Stash Save/Pop)

  • 如果您在某个分支上有未提交的更改,但需要临时切换到另一个分支处理紧急任务,又不希望现在提交这些更改,可以使用暂存功能。
  • 右键单击仓库文件夹,选择 TortoiseGit > Stash Save…
  • 完成其他任务后,回到原分支,右键单击仓库文件夹,选择 TortoiseGit > Stash PopStash List,可以将之前暂存的更改恢复。

四、总结

TortoiseGit作为一款强大的Git图形化客户端,通过其直观的Windows资源管理器集成,极大地降低了Git的学习曲线和使用难度。无论是版本控制新手还是经验丰富的开发者,都能通过它高效地进行代码管理、协作和版本回溯。掌握其安装、配置和日常操作,将使您的开发工作更加顺畅。

滚动至顶部