Git及其图形化工具TortoiseGit使用教程

适用人群：编程新手、github/gitee使用入门者、刚入行开发人员

学习目标：从零学会Git版本控制，脱离命令行，纯鼠标操作完成代码/文件的上传、更新、分支管理、冲突解决等操作

前言

很多新手最怕Git黑框命令行，记不住指令、输错命令就报错。其实日常开发完全可以用TortoiseGit图形化工具（小乌龟）替代命令行，所有操作鼠标点击即可完成，简单直观易上手、操作零门槛。

本文全程无复杂命令，从安装→配置→首次上传项目→日常提交更新→分支管理→冲突解决，覆盖99%新手开发场景，看完直接上手工作。

一、工具介绍：什么是Git？什么是TortoiseGit？

1. Git（核心底层工具）

Git是目前全球最主流的分布式版本控制工具，核心作用：

• 保存代码所有修改记录，不怕误删、改错代码
• 多人协作开发，互不覆盖代码
• 自由切换代码版本、开发新功能、回滚错误修改

注意：Git是底层核心，必须先装Git，再装TortoiseGit，否则图形工具将无法使用。

2. TortoiseGit（图形可视化工具）

TortoiseGit是Git的Windows图形化客户端，又叫“小乌龟”，最大优势：

• 全程鼠标点击操作，无需敲任何代码命令
• 与Windows文件管理器有很好的集成，各种状态图标直观显示（如下图）

• 操作界面中文可视化，新手零学习成本

二、全套软件安装（超详细步骤）

1. 安装顺序（必须遵守）

先装 Git → 再装 TortoiseGit（顺序错误会导致工具失效）

2. 安装Git（全程默认下一步）

下载地址：官网：https://git-scm.com/install/windows（如果因网络问题下载太慢或下载不了可以在电脑应用商店中搜索下载）

安装步骤：

1. 双击安装包，全部默认下一步，无需修改任何配置（如需修改安装位置可在步骤二中修改）
2. 安装完成后，桌面无图标，属于后台服务，无需打开

3. 安装TortoiseGit（重点配置）

下载地址：官网 ：https://tortoisegit.org/download

根据电脑系统选择安装包，同时下载中文语言包（方便新手使用）

安装步骤：

1. 先安装主程序：全程默认下一步，无需修改（如需修改安装位置可在步骤三中修改）
2. 再安装中文语言包：双击打开，直接下一步安装即可完成

1. 切换中文界面（如果勾选了上图选项可以跳过这一步）：桌面空白处右键 → TortoiseGit → Settings → General → Language 选择中文（简体），点击确定

4. 检查安装是否成功

电脑任意文件夹右键，能看到TortoiseGit 菜单，即代表安装成功。

三、首次全局配置（只做一次，永久生效）

安装完成后必须配置用户名和邮箱，否则无法提交代码（远程仓库不能识别开发者身份）。

操作步骤：

1. 桌面空白处右键 → TortoiseGit → 设置(Settings)
2. 左侧选择 Git 选项
3. 填写用户信息： 名称：自定义（建议和GitHub/Gitee用户名一致） Email：自己的注册邮箱
4. 勾选 全局(Global)（最重要！全局配置，所有项目生效）
5. 点击确定，配置完成

四、核心概念（新手必懂，避免踩坑）

不用记复杂理论，只懂这4个区域即可：

1. 工作区：你电脑本地的项目文件夹，平时写代码、放文件的地方
2. 暂存区：临时存放修改，相当于“待提交清单”，使文件受版本控制（不会推送至远程仓库）
3. 本地仓库：电脑本地的代码备份，保存所有提交的版本记录
4. 远程仓库：云端仓库（GitHub/Gitee/GitLab），团队共享、备份代码、存放文件

完整流程逻辑：本地修改 → 加入暂存 → 本地提交 → 推送到云端仓库

五、新手高频场景实操

场景一：全新本地项目，首次上传到远程仓库（最常用）

适用：自己新建的代码项目，第一次上传到GitHub/Gitee

步骤1：新建远程空仓库

1. 打开GitHub/Gitee，新建仓库
2. 不要勾选：初始化README、.gitignore、许可证（避免冲突）
3. 创建完成，复制仓库HTTPS地址

步骤2：本地项目初始化

1. 打开你的本地项目文件夹（所有代码、文件放在这里）
2. 文件夹空白处右键 →Git 在这里创建版本库
3. 弹窗直接点击确定（创建本地空仓库）

步骤3：添加所有文件到暂存区

右键 → TortoiseGit → 添加(Add) → 全选文件 → 确定

步骤4：提交到本地仓库

1. 右键 → Git 提交(Commit)
2. 上方输入日志信息（必填！例：首次提交，初始化项目）
3. 点击提交，等待提交完成 注：可以跳过暂存步骤直接提交，未暂存的文件将自动添加至暂存区，但需自己勾选

步骤5：关联远程仓库

1. 右键 → TortoiseGit → 设置 → 左侧选择 Git -> 远程(Remote)
2. URL粘贴刚才复制的远程仓库地址
3. 远程仓库名填写：origin（固定写法，不用改）
4. 点击添加 → 确定

步骤6：推送到远程云端

1. 右键 → TortoiseGit → 推送(Push)
2. 分支选择 master/main
3. 勾选 自动创建远程分支（没有则不选，默认自动创建）
4. 点击确定，输入仓库账号密码，推送成功

场景二：拉取远程已有项目到本地（克隆项目）

适用：下载别人的项目、公司项目到本地修改编辑

1. 新建一个空文件夹（用来存放项目）
2. 文件夹右键 → Git 克隆(Clone)
3. URL输入远程仓库地址
4. 目录选择当前空文件夹
5. 点击确定，自动下载全部代码，完成克隆

场景三：日常修改代码，更新上传（90%日常操作）

适用：改完代码、新增文件、删除文件，更新到云端

完整固定三步流程：

1. 第一步：更新本地代码（先拉后改，避免冲突） 右键 → TortoiseGit → 拉取(Pull)，同步云端最新代码到本地
2. 第二步：提交修改到本地 右键 → TortoiseGit → 提交(Commit) → 勾选所有修改文件 → 填写修改说明日志 → 提交
3. 第三步：推送到云端 右键 → TortoiseGit → 推送(Push) → 确定，上传完成

场景四：创建/切换分支（开发新功能、修复bug）

核心常识：master/main分支是主分支，只放稳定代码，新功能、bug修复必须新建分支开发

1.1 新建分支

1. 右键 → TortoiseGit → 创建分支
2. 输入分支名（例：fix-bug、new-function）
3. 勾选 切换到新分支 → 确定

1. 2切换分支

右键 → TortoiseGit → 切换/检出(Switch/Checkout) → 选择对应分支 → 确定

2. 分支合并（功能开发完成--同样需要提交和推送，合并到主分支）

1. 先切换回 master /main主分支
2. 右键 → TortoiseGit → 合并(Merge)
3. 选择需要合并的功能分支 → 确定，合并完成

场景五：解决代码冲突（多人协作必遇问题）

冲突原因：多人修改了同一个文件的同一行代码，Git无法自动合并

解决步骤：

拉取代码时提示冲突，文件图标会带上黄色警告标志

1. 右键冲突文件 → TortoiseGit → 编辑冲突，或者右键 → TortoiseGit → 解决冲突
2. 打开对比界面：上左方是远端仓库代码，上右方是本地代码，下方是合并代码。也可以手动打开冲突文件解决冲突
3. 手动保留需要的代码，删除多余冲突标记（<<<、=====、>>>）
4. 保存文件，右键标记为已解决冲突
5. 重新提交、推送即可

场景六：版本回退（改错代码，恢复历史版本）

适用：提交错误代码，需要撤回上一次/某次提交

1. 右键 → TortoiseGit → 显示日志(Show Log)
2. 查看所有提交记录，找到需要回退的版本
3. 右键该版本 → 重置“分支”到此版本
4. 选择重置模式：混合重置（默认） → 确定

六、TortoiseGit右键菜单按钮全解（新手必备）

很多新手只会照着步骤点按钮，却不知道每个功能的真正作用，遇到特殊场景就无从下手。本节按日常高频、分支管理、版本回溯、辅助工具四大类，详解 TortoiseGit 所有核心右键按钮含义、用途、使用场景，彻底吃透图形化工具功能，告别盲目操作。

一、日常高频核心按钮（95%日常开发使用）

1. 添加（Add）

作用：将本地新增、未被Git管理的文件，加入暂存区，让Git识别该文件，纳入版本管控。

适用场景：新建代码文件、新建配置文件、首次初始化项目批量添加文件。

新手须知：仅添加不保存，必须配合「提交（Commit）」才能真正记录到本地仓库。

2. 提交（Commit）

作用：将暂存区的所有修改，正式保存到本地Git仓库，生成专属版本记录，永久留存修改日志。

适用场景：写完功能、修复bug、修改配置后，保存本地版本。

强制规范：必须填写中文提交说明，清晰记录修改内容，方便后续追溯版本。

3. 拉取（Pull）

作用：拉取远程仓库最新代码，自动合并到本地项目，同步团队最新修改。

适用场景：上班打开项目、队友更新代码、多人协作开发前必操作。

核心习惯：先拉后改，避免本地代码与云端代码版本冲突。

4. 推送（Push）

作用：将本地已提交的版本记录，上传同步到云端远程仓库，实现代码备份、团队共享。

适用场景：本地功能开发完成、bug修复完毕，同步代码到云端。

5. 显示日志（Show Log）

作用：查看项目所有历史提交记录，包含提交人、修改时间、修改内容、版本哈希值。

适用场景：追溯代码修改记录、对比版本差异、回退错误版本、排查代码问题。

二、分支与协作专用按钮（团队开发必备）

1. 创建分支（Create Branch）

作用：基于当前分支，新建一个独立开发分支，分支之间代码完全隔离，互不影响。

适用场景：开发新功能、修复线上bug、尝试新代码，禁止在主分支直接开发。

小技巧：勾选「切换到新分支」，创建完成自动跳转，无需手动切换。

2. 切换/检出（Switch/Checkout）

作用：在多个分支之间自由切换，切换后本地代码会同步对应分支的最新版本。

适用场景：写完功能分支，切回主分支合并；切换到旧分支查看历史代码。

3. 合并（Merge）

作用：将一个分支的所有代码修改，合并到当前所在分支。

适用场景：新功能开发完成，将功能分支代码合并到主分支。

4. 抓取/获取（Fetch）

作用：拉取远程仓库最新版本记录，但不自动合并本地代码，仅同步远程分支信息和日志信息。

与Pull区别：Pull=Fetch+自动合并；Fetch仅同步数据，安全无冲突风险，适合仅查看更新、暂不合并的场景。

三、版本恢复与撤销按钮（改错急救专用）

1. 还原（Revert）

作用：撤销未提交的本地修改，恢复文件到上一次提交的状态。

适用场景：代码改乱、调试出错、误改文件，一键恢复初始状态。

特点：仅撤销本地未提交修改，不删除历史版本记录，安全无风险。

2. 重置（Reset）

作用：撤销已提交的版本，回退到指定历史版本，可清空错误提交记录。

三种模式区别（新手必懂）：

• 混合重置（默认）：回退版本，修改代码保留在本地，可重新修改提交（最安全、推荐）
• 软重置：回退版本，修改保留在暂存区
• 硬重置：彻底删除所有后续修改，数据不可恢复（谨慎使用！）

3. 储藏更改（Stash Changes）

作用：临时储藏当前未提交的所有修改，清空工作区，同时保留修改记录。

适用场景：正在开发新功能，临时需要切换分支改bug，不想提交半成品代码。

对应恢复：储藏后可通过「弹出储藏」恢复之前的修改内容。

四、辅助工具按钮（进阶实用功能）

1. 比较差异（Diff）

作用：对比当前文件与历史版本的所有代码差异，高亮显示新增、删除、修改的代码行。

适用场景：看不懂自己改了什么、排查代码报错、对比版本差异。

2. 追溯（Blame）

作用：逐行展示代码的修改记录，显示每一行代码的最后修改人、修改时间、提交版本。

适用场景：排查bug溯源、查看代码是谁修改、了解代码迭代逻辑。

3. 清理（Clean up）

作用：清理无效的未跟踪文件、缓存文件、残留配置，修复本地仓库轻微异常。

适用场景：文件图标显示异常、Git状态识别错误、本地缓存错乱。

4. 设置（Settings）

作用：TortoiseGit核心配置面板，可修改用户名邮箱、关联远程仓库、切换语言、自定义右键菜单。

适用场景：首次全局配置、更换远程仓库、界面中英文切换、修复关联异常。

五、新手极简操作口诀（快速记忆）

• 新文件用 添加，改完代码用 提交
• 上班更新用 拉取，写完功能用 推送
• 改错未提交用 还原，改错已提交用 重置
• 临时切分支用 储藏，查记录看差异用 日志/比较

七、文件状态图标含义（新手秒懂）

• 绿色对勾：文件正常，已提交
• 红色感叹号：文件已修改，未提交
• 蓝色加号：新增文件，未加入暂存区
• 黄色感叹号：代码冲突，需要手动解决

八、新手常见报错与解决方案

1. 提示fatal: remote origin already exists

原因：已关联过远程仓库

解决：右键设置 → 远程 → 删除原有origin，重新关联仓库地址

2. 推送失败，提示需要先拉取代码

原因：云端代码比本地新，存在版本差异

解决：先右键拉取(Pull)同步最新代码，再重新提交推送

3. 没有图标、右键无TortoiseGit菜单

原因：安装顺序错误或未重启资源管理器

解决：重启电脑，或右键刷新文件夹，重新安装（先Git后工具）

九、新手最佳使用习惯（避免99%问题）

1. 先拉后改：每次写代码前，先Pull拉取最新代码
2. 小步提交：写完一个功能就提交，不要一次性改大量代码（方便版本回退）
3. 分支开发：永远不在master/main主分支直接改代码
4. 提交信息清晰：写明修改内容，方便后续追溯版本

总结

TortoiseGit彻底解决了新手害怕Git命令的痛点，所有版本控制、代码协作操作，通过鼠标点击即可完成。本文覆盖了项目初始化、克隆、日常更新、按钮功能详解、分支管理、冲突解决、版本回退全核心场景，完全满足学习、实习、职场基础开发需求。熟练掌握这套流程和按钮功能，就能规范完成代码版本管理，适配绝大多数开发工作。