Git TortoiseGit 详细安装使用教程

news2024/12/23 23:48:47

前言

Git 是一个免费的开源分布式版本控制系统，是用来保存工程源代码历史状态的命令行工具，旨在处理从小型到非常大型的项目，速度快、效率高。《请查阅Git详细说明》。
TortoiseGit 是 Git 的 Windows Shell 界面工具，基于 TortoiseSVN。它是开源的，可以完全使用免费提供的软件构建。提供的支持，例如提交、显示日志、区分两个版本、创建分支和标签、创建补丁等。《请查阅TortoiseGit详细说明》。
TortoiseGit 必须依赖 Git 的环境配置运行，所以在安装 TortoiseGit 前，要先安装 Git 工具。

一、Git 安装使用教程

1.1 下载 Git 客户端

以 Windows 64 位系统为例，进行安装使用说明。

Git官网下载地址：Git Downloads

1.2 安装 Git 客户端

目前最新版本为 "Git-2.44.0-64-bit_2.exe"，直接双击运行。

进入安装导向界面，点击 <Next>

选择安装路径，然后点击 <Next>

接下来按照默认配置，一值点击 <Next> 即可

最后安装时，点击 <Install>

安装完成，点击 <Finish>

*注：如果不想看发行说明，在点击 <Finish> 前，先把 "View Release Notes" 的勾去掉。

1.3 验证 Git 客户端是否安装成功

在任意文件夹下点击右键，出现 "Git Bash here" 快捷键表示安装成功
输入 "git --version" 查看版本信息

1.4 使用 Git 客户端创建 SSH 密钥

查看 SSH 公钥的方法：在任意文件夹下点击右键，选择 Git GUI here。弹出的界面如下：

点击主菜单的【Help】→【Show SSH Key】

*注：如果没有 SSH 密钥，界面内容是空白的。

点击 "Generate Key" 生成 SSH 密钥（如果设置密码为空，直接点击OK即可）
点击 "Copy To Clibboard"，把 SSH 的公钥粘贴到 Git 服务器的配置中【具体参考: 2.4.2】

SSH 密钥说明：

1. 点击 "Copy To Clibboard" 是把 SSH 公钥复制到粘贴板；

2. 通过 Git 生成的密钥一般都存在 C:\Users\XX\.ssh 目录下（其中 XX 是表示电脑账户）。

1.5 Git 拉取远程服务器源码

为了验证 Git 客户端可用，在 github 上随便拉取一份经典的开源代码，成功下载中...

二、TortoiseGit 安装使用教程

2.1 TortoiseGit 客户端与语言包下载

以 Windows 64 位系统为例，进行安装使用说明。

TortoiseGit官网下载地址：Download TortoiseGit

*注：目前最新稳定版本为 2.15.0.0。如果大家不习惯使用英文版本，可以下载中文语言包安装。

2.2 TortoiseGit 客户端与语言包安装

安装顺序特别说明：

1. 先安装 TortoiseGit 客户端;

2. 再安装语言包；

*注意：

TortoiseGit 客户端安装到首次出现导向界面时，会有语言的选项；
此时，可先把中文语言包安装完成，再点击 TortoiseGit 刷新按钮，然后选择中文简体即可。

2.2.1 TortoiseGit 客户端安装

直接双击运行，然后点击 <Next> 默认安装

*注：如果不想安装到C盘，可自行选择安装路径

剩下的安装流程，一直点击 <Next> 默认安装即可
安装到导向界面时，先不要点击"下一页"
可以先跳到 步骤【2.2.3】完成语言包安装后，再回来接着操作

此时，假设你已跳到 步骤【2.2.3】完成了语言包安装
接着点击刷新按钮，选择中文简体

点击 <下一页>，系统会自动选择 git.exe 运行环境，默认即可

安装过程中，需要填写个人 git 账号和邮箱

2.2.2 使用 PuTTYgen 创建 SSH 密钥

如果你之前没有按照【1.4】步骤使用 Git 客户端创建 SSH 密钥
在此，还可以通过 TortoiseGit 自带的 PuTTYgen 工具创建 SSH 密钥
点击 "Generate PuTTY key pair" 创建 SSH 密钥

点击 "Save private key" 保存 SSH 私有密钥（要记住保存路径！！！）
将 Public Key 复制粘贴到 Git 服务器上，配置 SSH Key【具体参考: 2.4.2】

注：我选择在 Documents 下创建一个 ssh 目录来存放 SSH 密钥对（私钥和公钥）。

2.2.3 安装中文语言包

直接双击运行，一直默认安装即可

2.2.4 查看 TortoiseGit 汉化情况

完成 步骤【2.2.1】和【2.2.3】安装后，在任意文件夹点击右键，可以看到 TortoiseGit 已成功汉化

2.3 TortoiseGit 常规配置

如果你在上述的安装过程，不小心错过了一些关键步骤，也不必惊慌，在此将会重新介绍。

2.3.1 TortoiseGit 菜单配置

在本地创建一个空目录 (例如 Test)，建议: 路径中不要包含中文
在空白处点击右键, 选择 TortoiseGit --> Settings

在空白处重新点击右键，可以看到弹出菜单已经汉化成功

从上图可以看到 "Git 克隆" 字样会显示在右键菜单里
点击 “设置” -- "右键菜单"，把复选框的默认勾选都去掉，让右键菜单保持干净。

2.3.2 TortoiseGit 客户端 Git 配置

以下内容将会介绍，如何解决每次拉取或提交代码时，免除输入用户名及密码的操作。

每次通过 TortoiseGit 拉取或提交代码，默认会要求输入用户名和密码

2.3.2.1 方法一：永久免除输入用户名和密码

在任意文件夹点击右键，选择 "TortoiseGit" -- "设置" -- "Git"
先填写自己远程服务器的用户名及邮件，然后点击 "应用"

再点击 "编辑全局.git/config(O)"
打开全局配置文件，并且添加如下内容

[user]
	name = test
	email = test@example.com
    signingkey = admin
[credential]
    helper = store

添加的内容说明：

name：服务器用户名称（例如 test）
signingkey：服务器用户密码（例如 admin）
Email：提供给别人联系的邮箱
helper = store：永久记住服务器的用户名和密码（这个配置是免密的关键）

2.3.2.2 方法二：只对指定仓库免除输入用户名和密码

在一个已经拉取远程服务器项目代码的目录里 (例如 Test)，只对当前项目仓库免密操作
在当前目录点击右键，选择 "TortoiseGit" -- "设置" -- "Git" -- "编辑本地.git/config(L)"

在打开的文件里，添加如下内容
保存后，以后在这个仓库下拉取或提交代码，就不用重复验证了，因为小乌龟已经记录下了当前仓库的用户和密码。

[credential]
  helper = store

2.4 TortoiseGit 秘钥配置

2.4.1 SSH 密钥创建

关于 SSH 密钥创建方法，我已经在【1.4】和【2.2.2】小节都已经说过了
这两种方法，任意选择其中一种方法创建即可
如果你错过了【2.2.2】的创建方法，并且还想用 PuTTY 来创建 SSH 密钥
那么可点击电脑 "开始" --> "PuTTYgen"，进入 PuTTY Key Generator
具体操作方法请参考：步骤【2.2.2】

2.4.2 将 SSH 公钥填写到 Git 服务器配置

这里以 GitBlit 服务器为例：

方法一：参考步骤【1.4】，点击 "Copy To Clibboard"，把 SSH 的公钥粘贴 GitBlit 服务器对应用户的后台配置中
方法二：参考步骤【2.2.2】，在 "PuTTY Key Generator" 界面，将 Public Key 复制粘贴GitBlit 服务器对应用户的后台配置中
以上方法，任选一种即可