简介：这份 TortoiseGit 使用教程面向 Windows 下刚接触 Git 的开发者、需要图形化版本控制的学习者以及希望减少命令行操作的前端与测试人员，重点解决右键菜单不熟悉、安装配置繁琐、HTTPS 与 SSH 连接方式选择困难等入门问题。压缩包内共 1 个 docx 文件，约 1.15MB，以图文步骤组织环境安装、中文界面设置、用户名邮箱配置、凭证助手保存密码、SSH Key 生成与上传、仓库克隆、拉取合并、提交推送和分支管理等操作。已有 2150 人学习，内容还穿插文件状态角标说明、两种远程连接方式对比和常见报错提示，读者可对照文档在资源管理器中直接实践，逐步掌握从本地仓库到远程协作的完整流程。

1. 先把话说白：TortoiseGit 到底是个什么东西

很多人的第一次困惑来得很突然：照着某篇 Git 图文教程把软件装完，回到文件夹里一右键，菜单上凭空多出「Git 提交」「Git 同步」一长串陌生选项，一个都不敢按。这篇 TortoiseGit 使用教程先把最要紧的一句话说清楚：TortoiseGit 是 Windows 上的一个图形外壳，它把 Git 那些要敲命令才能做的操作，翻译成你右键就能点到的菜单项。Git 是发动机，负责真正记录每一次改动；TortoiseGit 是方向盘和仪表盘，让你不用背命令也能把车开走。它适合刚接触版本管理、习惯用鼠标、暂时不想跟命令行较劲的人，尤其是手里只有一台 Windows 电脑、想先把流程跑通再说的新手。

2. 为什么值得先学它：一个右键菜单能改变什么

装软件之前先问自己一句「我为什么要装」，比装完再研究怎么用要省事得多。版本管理这个词听起来很重，其实它解决的事情特别朴素：你改坏了东西之后，还能退回去；你和别人一起改同一份文件时，能知道谁在什么时候动了哪一行。这一章不碰任何安装步骤，只把三个问题讲透——Git 和小海龟到底谁是谁、图形界面替你省掉了什么、以及你打算拿它管什么。

2.1 Git 和小海龟不是一回事：一台发动机和一套方向盘

先说说没有版本管理的日子是什么样的。很多人管文件的方式是堆文件名：报告.doc、报告_修改.doc、报告_最终.doc、报告_真的最终_改.doc。这套办法在只有你一个人、只改两三天的时候勉强能用，一旦文件多起来、时间拉长到几个月，你自己都分不清哪个是最新的，更别说找回上周三删掉的那一段。更麻烦的是协作，两个人各自改一份发来发去，最后合并的时候只能靠眼睛一行一行对，翻车概率极高。

Git 就是来收拾这个场面的。它会在你每次「提交」的时候，给当前所有文件拍一张快照，并且记下这张快照是谁在什么时候、因为什么原因拍的。想回到三天前的状态，切回去就行；想知道某一行是谁改的，查一下就有答案。这个过程全部存在你本地的一个隐藏文件夹里，不联网也能用。

而 TortoiseGit 本身不存任何版本。它做的事情是：把 Git 提供的能力包装成菜单项，再给菜单配上中文和图标。你点「Git 提交」，它在背后替你执行的是同一条 Git 命令；你点「Git 推送」，它也是转手把活交给 Git 干。所以安装顺序上有一条铁律：先装 Git，再装小海龟。只装小海龟会是什么下场？右键菜单照样能弹出来，每个选项都能点，但点下去十有八九报错，因为它找不到那个真正干活的 Git 程序。这个坑每年都有大量的新手踩进去，而且报错信息往往只有一行英文，看不出问题出在顺序上。

记住这个分工：Git 是仓库管理员，负责记账、存档、对账；TortoiseGit 是柜台上的指示牌和中英文对照表，让你不用听懂管理员的行话也能办事。管理员不在，指示牌做得再漂亮也没用。

2.2 图形界面到底替你省掉了什么：五条命令换成五次点击

新手最容易产生的误解是「图形界面是简化版、功能不全」。实际上小海龟调用的就是同一套 Git，你在菜单里点出来的每一次提交，和命令行里敲出来的提交是同一种东西，没有高下之分，只是入口不同。

把最常用的五个动作摆在一起对照，你就能看明白省掉的到底是什么：

省掉的不是功能，是三样东西。第一是记忆成本，你不用背参数，需要什么就在菜单里找。第二是路径成本，命令行要先 cd 到项目目录，图形界面是你站在哪个文件夹里，右键就是哪个文件夹。第三是反馈成本，命令行出错时往往只吐一行英文，小海龟至少会弹一个带进度条的窗口，告诉你卡在哪一步。

但也要说句公道话：命令行有它不可替代的地方。命令可以复制粘贴、可以写成脚本、可以远程操作服务器，这些是图形界面做不到的。所以比较合理的路径是——先用小海龟把整个流程跑通，建立起「提交、拉取、推送分别对应什么」的直觉，等这套直觉长在身上了，再回头看命令，你会发现那些参数一点都不难记，因为你已经知道它们要解决什么问题。反过来，一上来就啃命令，很多人卡在第三行就放弃了。

血泪经验是：不要在同一段时间里既学命令行又学图形界面。新手最怕的就是同一件事有两套说法，脑子会打架。先选一条路走通，另一条随时可以补。

2.3 动手之前先想清楚：你打算拿它管什么

工具本身没有好坏，只有合不合适。小海龟最适合的场景有这么几类：个人写代码或者做课设，需要保留每一次修改的过程；几个人一起维护一堆文档、配置或者脚本，需要知道谁改了什么；以及从别的版本管理工具迁移过来、习惯了「右键出菜单」这种操作方式的人。

不太适合的场景也要说清楚。Git 存的是每一次提交的完整快照，它对纯文本文件极其友好，对几百兆的设计稿、视频、安装包就不太友好了——不是不能存，是存几次之后仓库会膨胀到难以收拾。这类文件更适合放到专门的文件存储里，仓库里只留一个说明和链接。另外，如果你的电脑是 Mac 或者 Linux，那这套右键菜单的方案就不适用了，那些系统上有别的图形客户端可选。

还有一个很实在的建议：第一个用来练手的仓库，千万别是你明天就要交的东西。新建一个空仓库，扔两个无关紧要的文本文件进去，随便改、随便提交、随便推，甚至故意搞出冲突看看会怎样。练习仓库的最大价值就是它可以被你弄坏，而弄坏之后不会有人来找你麻烦。等你把这套动作练到不用想，再往真正重要的项目上搬。

3. 从零搭环境：安装顺序和四项必做配置

装软件这件事，顺序比速度重要。这一章按照「装什么、配什么、选哪条路」三步走，每一步都落到你能直接照着点的位置。整个过程大概二十分钟，中途不需要重启电脑，但建议留出一段不被打断的时间，因为配置项里有两处填错会导致后面所有操作都失败，而报错信息又不会直接告诉你错在哪。

3.1 顺序不能反：先 Git，再小海龟，最后语言包

三样东西，安装顺序是固定的。

第一步，装 Git 的 Windows 版本。去 Git 的官方站点找到 Windows 下载入口，下载安装包，一路默认「下一步」即可。安装过程中会让你选一个安装目录，这个目录要记下来，后面填路径要用。默认路径通常在一个带 Program Files 的位置，如果你改到别处，拿张纸记一下也行。

第二步，装 TortoiseGit 本体。同样的流程，一路下一步。安装过程中它会问你要不要顺便配置，先跳过，装完再统一配。

第三步，装中文语言包。语言包是一个独立的小安装程序，它的版本要和刚装的小海龟本体对得上，版本错位的话语言列表里可能根本看不到中文选项。

装完之后先验证一下。打开命令提示符或者 PowerShell，敲：

# 确认 Git 本体已经装好并且能在任意目录下调用 git --version # 正常会打印一行版本号，形如 git version 2.x.x.windows.1

如果这行命令返回了版本号，说明 Git 已经就位；如果提示「不是内部或外部命令」，说明要么没装成功，要么装的时候没勾选加入环境变量，这时候把小海龟的菜单点烂了也没用，得先把 Git 补上。

提示：Git 和小海龟的安装路径里尽量不要带中文和空格，后面填 git.exe 所在目录的时候，能省掉一批莫名其妙的报错。

3.2 打开设置，把这四项配到位

装完只是把零件摆上桌，配置才是把螺丝拧紧。找一个你打算专门用来放项目的目录，比如 E 盘下建一个 Git 文件夹，进到这个文件夹里，在空白处点右键，选 TortoiseGit 那一项里的 Settings，配置界面就出来了。需要动的地方有四处。

第一处是界面语言。在左边选中 General，右边有一个 Language 下拉框，选简体中文，确定之后菜单就变中文了。顺手把「自动检查更新」的勾去掉，这个功能会在你每次右键的时候偷偷联网，网络不好时菜单会卡顿几秒，很多人以为是软件坏了，其实是它在等超时。同一页里还有一个 Git 可执行文件路径的输入框，如果你刚才装 Git 时改过目录，这里要手动指过去，指到 Git 安装目录下的 bin 文件夹为止。

第二处是个人标识。左边切到 Git 这一页，右边能填 Name 和 Email。这两个不是登录账号，而是写进每一次提交记录里的签名，方便以后别人知道这行改动是谁做的。填你常用的昵称和邮箱就行，不用和任何账号密码一致。

第三处是记住密码。这一页上有两个按钮，「编辑全局配置」和「编辑本地配置」，其中本地那个在没有打开具体项目的时候是灰的，这是正常现象，不是软件坏了——它只对某个具体项目生效。点全局那个按钮，会用记事本打开一个配置文件，在文件末尾追加两行：

# 让 Git 记住 HTTPS 方式用到的账号密码，省得每次推送都重输 git config --global credential.helper store # 顺便用命令把签名也写进全局配置，效果和在界面里填一样 git config --global user.name "你的昵称" git config --global user.email "you@example.com"

第一行是告诉 Git 把凭据存起来，第二三行是设置提交签名。用命令改和用记事本改，落到磁盘上是同一个文件，效果完全一样，选你顺手的就行。

第四处要特别提醒：store这个模式是把账号密码以明文形式保存在你用户目录下的一个文件里。个人电脑上方便，公用电脑或者多人共用的机器上就别开了，那种情况宁可每次手动输。这就是为什么很多人说「配了记住密码，电脑借人之前记得清一下」。

顺便解释一下全局和局部的区别，这是新手最容易糊涂的地方。全局配置相当于你的默认习惯，对所有项目生效；局部配置写在某个项目自己的隐藏目录里，只对这个项目生效，并且优先级更高。典型用法是：全局填你个人的昵称邮箱，某个公司项目里单独配一个工作邮箱，这样提交记录不会串。

3.3 HTTPS 还是 SSH：第一次该选哪条路

克隆一个远程仓库，地址有两种写法，这两种写法对应两套认证方式，新手经常在这里卡住。

HTTPS 方式的地址看起来像一个普通网址。它的好处是开箱即用，复制粘贴就能克隆，不需要提前做任何配置。坏处是每次拉取和推送都要验证身份，虽然可以用上一节说的方式记住密码，但那毕竟是把密码存在本地。

SSH 方式的地址开头是 git@ 那一串。它需要你先在本地生成一对密钥，把其中可以公开的那一半交给服务器，之后所有操作靠这对密钥自动验证，不用再输密码。缺点是第一次配置略绕，而且配错了报错信息相当难懂。

给新手的建议很明确：第一次先用 HTTPS 把流程跑通，等你确确实实每天都要推代码了，再回来折腾 SSH。因为 HTTPS 出问题时，你至少能确定问题出在账号密码上；SSH 出问题时，可能是密钥没生成、公钥没贴对、权限设置不对、地址复制多了空格，每一种的表现还都很像。

如果你决定直接上 SSH，生成密钥可以不用命令行。在任意文件夹空白处右键，选 Git GUI Here，在弹出的窗口里找帮助菜单下的显示密钥项，如果没有现成的密钥，点生成按钮，然后按提示移动鼠标等进度条走完。生成之后，去用户目录下看有没有一个 .ssh 文件夹：

# 在 Windows 命令提示符里检查密钥对是否已经存在 dir %USERPROFILE%\.ssh # 看到 id_rsa 和 id_rsa.pub 两个文件，就说明生成成功了

这两个文件是一对：带 .pub 后缀的是公钥，可以放心交给任何人，你要贴到代码托管平台的设置页面里的就是这个；不带后缀的是私钥，它相当于你家的钥匙，绝对不能发给别人，也不该传到任何仓库里。把公钥内容完整复制，粘贴到托管平台的密钥设置里保存，之后用 SSH 地址克隆就不用再输密码了。

4. 第一个能跑通的例子：从克隆到推送完整走一遍

前面都是铺垫。这一章带你走一遍完整流程：从远程仓库克隆到本地，改一个文件，提交到本地仓库，拉取别人的更新，再推送回去。走完这一遍，你就掌握了日常百分之八十的使用场景。下面每一步都写了「点哪里」和「为什么」，建议真的打开电脑跟着做，光看是看不进去的。

4.1 克隆：把远程仓库搬到本地

先准备一个专门放项目的目录，比如 E 盘下的 Git 文件夹。进去之后在空白处右键，选 Git 克隆。弹出来的对话框里有两个关键输入：上面填远程仓库的地址，下面选本地存放位置。地址填 HTTPS 或者 SSH 都行，取决于你在上一章选了哪条路。填完点确定，会弹一个带进度条的窗口，跑完就说明搬完了。

搬完之后，那个文件夹的图标上应该会多出一个小角标。为了确认真的完整，可以打开命令行核对一下：

# 进入刚克隆下来的项目目录，/d 参数用于在 Windows 下切换盘符 cd /d E:\Git\你的项目名 # 查看当前状态，这是最常用的一条命令 git status

cd /d里的/d是让你能从 C 盘跳到 E 盘，不加这个参数的话切不过去。git status会告诉你当前在哪个分支、有没有未提交的改动。如果输出里写着工作区干净、没有待提交的内容，说明克隆是完整的。

注意：远程仓库里至少要先有一个文件，哪怕只是一个空的说明文档。如果对面是个彻彻底底的空仓库，克隆是能成功的，但后面拉取会报一个「找不到 HEAD」的错误，新手看到这行英文基本都会懵。

4.2 改一个文件，提交到本地

克隆下来之后，随便改点东西。打开项目里的说明文档改两行，再新建一个文本文件叫 Hello.txt，随便写一句话保存。这时候你回到文件夹，会发现被改过的文件角标变了，新建的文件角标也不一样，这就是下一小节要讲的图标含义。

接下来把改动记进本地仓库。在项目文件夹空白处右键，选 Git 提交，注意菜单上会跟一个分支名，比如 master。弹出的对话框分三块：上面是提交说明，中间是文件清单，每个文件前面有勾选框，下面是按钮。勾选你要提交的文件，在说明框里写一句人话，比如「新增 Hello.txt 并补充说明文档」，然后点提交。

用命令行理解这两步在干什么，会清楚很多：

# 第一步：挑出要打包的文件，点代表当前目录下所有改动 git add Hello.txt # 第二步：把挑好的改动打包成一张快照，引号里是说明 git commit -m "新增 Hello.txt 并补充说明文档"

add是挑选，commit是封存。图形界面把这两步合并在一个对话框里了：那些勾选框就是add，提交按钮就是commit。提交说明别写「更新」「修改」这种词，一个月后你自己都看不懂当时干了什么，写「修复登录按钮点两次才跳转」这种一句话，才是给自己留后路。

提交成功之后会弹一个提示窗口。这里有个新手最常见的误会：以为点了提交，服务器上就有了。没有。提交只是把改动存进了你本地的仓库，服务器那边一无所知。要送上去，还得再走一步推送。

4.3 先拉后推：同步、冲突和推送

从本地推送到远程之前，中间还差一步，就是先看看服务器上有没有别人推的新东西。顺序是先拉后推，这个习惯值得从第一天就养成。

在项目文件夹上右键，选 Git 同步，会打开一个窗口，里面列出拉取、推送这些操作。先点拉取。如果这期间没有别人动过这个仓库，它会提示你已经是最新，那你就可以直接点推送。如果别人推过新内容，拉取会把这些改动合并到你本地，一切正常的话也是悄无声息。

麻烦出现在冲突的时候：你和别人改了同一个文件的同一处，Git 不敢替你决定留谁的，于是把两边的内容都塞进文件里，用几行尖括号标出来，同时文件角标变成黄色感叹号。这时候需要你打开那个文件，手工决定保留哪一段、删掉哪一段和所有标记符号，然后重新提交一次，冲突才算解决。

推送的方式有两种：提交成功后的提示窗口上直接有推送按钮；或者在同步窗口里点推送。弹出来的对话框一般保持默认就行，点确定，会让你输入账号密码，验证通过后显示推送成功。如果上一章配好了记住密码，这一次输完，后面就不用再输了。

需要强调的一点：修改本地文件之前，先拉一下。这个习惯和用别的版本管理工具是一样的，能挡掉八成的冲突。很多人是改了两小时才发现拉不下来，那时候解决冲突的成本已经很高了。

4.4 看懂那七个角标：文件图标在说什么

克隆完之后你会发现，文件和文件夹的图标上多了小标记。这些小标记是整套工具里最直观的信息来源，看懂它们，你不用点开任何菜单就知道当前是什么状态。

蓝色问号和蓝色加号最容易混：问号是「Git 压根不知道有这个文件」，加号是「你告诉过 Git 要管它了，还没提交」。这两个状态的差别，决定了你提交的时候它会不会被带上。很多人说「我明明新建了文件，怎么推上去没有」，原因往往就是它一直停在问号状态，从来没被添加过。

5. 新手最容易翻车的地方：五个高频问题的排查

这一章集中处理那些「明明照着做了，就是不生效」的情况。每一条都按现象、原因、解决三段来讲，你可以当成一本小手册，遇到问题时直接翻到对应的那一条。需要提前说明的是，这里列的都是入门阶段的高频问题，不涉及复杂场景，先把这些趟平，日常使用基本不会卡住。

5.1 图标角标一个都不显示

现象：所有文件都是白板图标，一个角标都没有，但右键菜单是正常的，操作也能成功。

原因：Windows 系统给图标覆盖预留的位置是有限的，装了几个网盘、同步盘之类的软件之后，这些位置可能被占满了，小海龟排不上号。另一种可能是图标覆盖功能被关掉了。

解决：先在小海龟的设置里找到图标覆盖那一页，确认相关选项是勾上的。如果勾了还是不显示，就要处理槽位占用的问题，比较省事的做法是关掉几个不常用的同步类软件再重启资源管理器。还有一种极端情况是安装时选了不装图标组件，那就需要重新运行安装程序补上。顺带说一句，这个现象属于玄学范畴，有时候重启一次电脑就好了，别在它上面耗太久，毕竟角标只是视觉提示，不影响实际功能。

5.2 每次推送都要重新输账号密码

现象：配置里明明开了记住密码，第二次推送还是弹框要你输。

原因：三种可能。一是配置写到了局部而不是全局，只在某一个项目里生效，换个项目就不认了。二是你克隆时用的是 SSH 地址，但没配密钥，这种情况下记住密码那一套根本用不上。三是密码改过，本地存的旧凭据失效了，系统还在拿旧的去试。

解决：先确认全局配置文件里确实有那两行凭据设置，可以在设置界面点全局配置按钮打开文件核对。再确认你用的克隆地址是 HTTPS 还是 SSH，两种方式不通用。最后，如果怀疑是旧凭据的问题，去系统自带的凭据管理器里把对应的那条删掉，下次推送重新输一遍，就会存新的了。

5.3 拉取提示冲突，文件上挂了黄色感叹号

现象：点拉取，进度条跑到一半停住，提示有冲突，某个文件的角标变成了黄色感叹号。

原因：你和服务器上的版本都改动了同一个文件的同一处，Git 没法替你判断该保留哪个，于是把两边的内容都留在文件里等你决定。这不是错误，是它在向你求助。

解决：打开那个冲突文件，会看到几行尖括号标记，中间夹着两段内容，上面那段是你本地的，下面那段是服务器上的。手工把文件编辑成你最终想要的样子，把所有尖括号标记删干净，保存。然后回到小海龟，把这个文件标记为已解决，再提交一次，最后推送。整个过程的关键是：一定要把标记符号删干净，留着它们的话文件内容里会混进一堆乱码一样的字符。

5.4 克隆下来是空的，或者报找不到 HEAD

现象：进度条跑完了，打开文件夹一看什么都没有；或者直接报错，提示找不到远程的 HEAD。

原因：远程仓库是新建的空仓库，一个提交都没有。Git 需要至少一个提交才能确定「最新版本」是什么，空仓库没有这个参照物，所以它不知道要给你什么。

解决：去远程仓库那边先建一个文件，哪怕只有一个标题也行，提交上去，然后再回来克隆。如果你是仓库的创建者，也可以反过来操作：先在本地把项目建好、提交一次，再推送到远程，这样远程仓库就有了第一个提交。这个报错看着吓人，实际上是最无害的一种。

5.5 提交成功了，推送却被拒绝

现象：本地提交显示成功，日志里也能看到记录，但一推送就被拒绝，提示远程有本地没有的提交。

原因：在你改代码的这段时间里，别人往同一个分支推了新东西。你的本地历史和服务器的历史出现了分叉，Git 不愿意用你的版本去覆盖别人的工作，所以拦住了。

解决：老老实实先拉取，把别人的改动合并进来，解决可能出现的冲突，再推送。这里有件事千万不要做：不要去找那个强制推送的选项。强制推送会用你本地的历史直接覆盖服务器，别人推上去的东西可能就没了，这种操作造成的损失基本没有后悔药可吃。养成先拉后推的习惯，这类问题会少很多。

6. 下一步学什么：从会点右键到看得懂命令行

把前面五章的内容走完，你已经能独立完成「克隆、修改、提交、拉取、推送」这一套动作了。接下来该往哪走，我按难易顺序给你排了一条路，每一步都写了判断标准，达标了再往下走，别贪快。

第一层其实你已经在做了，缺的只是重复次数。找一个自己的小项目，每天改一点、提交一次，连着做一周，手感自然就有了。

第二层最容易被跳过，但它价值很高。小海龟的显示日志功能能列出每一次提交，点开某一次能看到具体改了哪些行。学会看这个，你在排查「这段代码什么时候变成这样」的时候会快很多。

第三层是分水岭。分支的意思是：你可以从主线拉出一条岔路，在上面随便折腾，折腾好了再合回去，折腾坏了直接删掉，主线一点不受影响。新手最常见的做法是所有改动都在主线上做，一旦改崩就只能硬着头皮修。

第四层是我建议你一定要走到的。图形界面能覆盖日常操作，但遇到报错、遇到自动化脚本、遇到需要在远程机器上操作的时候，命令行的优势就出来了。而且因为你先有了图形界面的直觉，回头学命令会很顺，你会发现git status输出的那几行英文，你早就知道它在说什么了。

我第一次带新人时，最常听到的一句话是「我点提交了，怎么服务器上没有」。这句话背后其实是对「本地」和「远程」这两个空间没有概念。从那以后我每次教人，都强制对方先完整走一遍「拉取、修改、提交、推送」四步，再碰任何别的功能，包括分支、包括命令行。因为流程跑通了，剩下的都是在这条主干上长出来的枝叶。希望帮到你。

本文还有配套的精品资源，点击获取