Git & TortoiseGit 详细安装使用教程_tortoisegit安装包

前言

• 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 服务器对应用户的后台配置中
• 以上方法，任选一种即可

• 如果你选择了方法二，将 Public Key 粘贴到 Git 服务器配置里
• 那么点击打开 "开始" --> "Pageant"
• 添加前面 步骤【2.2.2】生成的 SSH 私钥 ssh-rsa.ppk。然后关闭

 

Pageant 添加 SSH 私钥的说明：

• 远程服务器已经添加了 SSH 公钥
• 使用 TortoiseGit 客户端向服务器拉取或提交代码时，Pageant 必须启动且添加了对应的私钥。否则会报错！！！

三、TortoiseGit 客户端与服务器交互

3.1 克隆或拉取远程服务器代码 

• 新建 Test 目录，然后点击右键 --> "TortoiseGit" --> "克隆"
• 输入远程服务器URL，选择 Putty 密钥 (即 SSH 私钥)
• 点击确定，开始拉取服务器版本库代码

 

3.2 本地仓库提交代码到远程服务器

• 新增文件
• 修改文件内容 
• 描述提交日志信息
• 将代码或新增文件，提交到远程服务器
• 点击推送(到远程服务器)
• 最后点击 "确定" 即可

 

四、Git 服务器安装使用教程 

• 如果公司或个人想在 Windows 环境下搭建私有的 Git 服务器
• 那么，这个开源的 GitBlit 是一个不错的选择
• 详细教程请查阅《Windows搭建GitBlit服务器详细教程》