TortoiseGit 文档

1. 工具介绍

TortoiseGit 是一个 Windows 平台上的 Git 客户端工具，它为 Git 版本控制系统提供了友好的图形用户界面（GUI）。TortoiseGit 集成在 Windows 资源管理器中，通过右键菜单即可执行各种 Git 操作，无需使用命令行，大大简化了 Git 的使用流程。

主要特性

• 完全集成于 Windows 资源管理器：通过右键菜单执行所有 Git 操作
• 直观的操作界面：图形化展示 Git 操作和结果
• 支持所有 Git 核心功能：提交、分支、合并、推送、拉取等
• 多语言支持：包括中文在内的多种语言界面
• 强大的冲突解决工具：内置可视化冲突解决器
• 子模块支持：方便管理包含子模块的项目
• Git Flow 集成：支持 Git Flow 工作流程

2. 系统要求

硬件要求

• 处理器：1 GHz 或更快的处理器
• 内存：至少 1 GB RAM
• 硬盘空间：至少 100 MB 可用空间

软件要求

• 操作系统：Windows 7/8/10/11
• Git for Windows：TortoiseGit 依赖于 Git 命令行工具，需要先安装 Git
• .NET Framework 4.7.2 或更高版本

3. 安装步骤

步骤 1：安装 Git for Windows

1. 访问 Git 官网 下载最新版本的 Git for Windows
2. 运行安装程序，按照默认设置进行安装
3. 安装完成后，打开命令提示符，输入 git --version 验证安装是否成功

步骤 2：安装 TortoiseGit

1. 访问 TortoiseGit 官网 下载最新版本的安装包
2. 运行安装程序，选择语言（建议选择中文）
3. 在安装向导中，保持默认选项，点击「下一步」直到完成安装
4. 安装完成后，系统会提示重启电脑以完成集成

步骤 3：安装语言包（可选）

如果安装时没有选择中文，或者需要其他语言界面：

1. 在 TortoiseGit 官网下载对应版本的语言包
2. 运行语言包安装程序，按照提示完成安装
3. 在 TortoiseGit 设置中切换到对应语言

4. 基本配置

首次配置

安装完成后，首次使用 TortoiseGit 需要进行基本配置：

1. 在任意文件夹上点击右键，选择「TortoiseGit」→「设置」
2. 在「常规设置」中，设置「用户名」和「电子邮箱」（建议与 Git 全局设置保持一致）
3. 在「Git」选项卡中，确保「Git.exe 路径」正确指向 Git 安装目录
4. 在「外观」选项卡中，可选择界面语言
5. 点击「应用」和「确定」保存配置

配置 Git 全局设置

虽然 TortoiseGit 提供了图形化配置界面，建议同时通过命令行设置 Git 全局配置：

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
git config --global core.autocrlf true  # Windows 环境推荐设置
git config --global core.safecrlf true

5. 常用操作指南

克隆仓库

1. 在目标文件夹上点击右键，选择「Git 克隆...」
2. 在弹出的对话框中，输入仓库 URL
3. 选择本地目录（默认为当前文件夹）
4. 点击「确定」开始克隆

提交更改

1. 在修改过的文件或文件夹上点击右键，选择「Git 提交 -> "master"...」
2. 在提交对话框中，选择要提交的文件
3. 输入提交信息，描述本次更改的内容
4. 点击「确定」完成提交

推送更改

1. 提交完成后，在仓库文件夹上点击右键，选择「Git 推送...」
2. 在推送对话框中，确认远程仓库和分支
3. 点击「确定」开始推送

拉取更新

1. 在仓库文件夹上点击右键，选择「Git 拉取...」
2. 在拉取对话框中，确认远程仓库和分支
3. 点击「确定」开始拉取

创建和切换分支

1. 在仓库文件夹上点击右键，选择「TortoiseGit」→「创建分支...」
2. 输入分支名称，选择基于哪个分支创建
3. 点击「确定」完成分支创建
4. 切换分支：在仓库文件夹上点击右键，选择「TortoiseGit」→「分支」→「切换/检出...」，选择要切换的分支

合并分支

1. 切换到要合并到的目标分支
2. 在仓库文件夹上点击右键，选择「TortoiseGit」→「合并...」
3. 选择要合并的分支
4. 点击「确定」开始合并
5. 如果有冲突，解决冲突后提交合并结果

6. 高级功能

Git Flow 工作流程

TortoiseGit 内置支持 Git Flow 工作流程：

1. 在仓库文件夹上点击右键，选择「TortoiseGit」→「Git Flow」→「初始化仓库...」
2. 按照默认设置初始化 Git Flow
3. 使用「开始功能」、「完成功能」等命令管理特性分支
4. 使用「开始发布」、「完成发布」等命令管理发布流程

子模块管理

1. 添加子模块：在仓库文件夹上点击右键，选择「TortoiseGit」→「子模块添加...」
2. 输入子模块 URL 和路径
3. 点击「确定」完成添加
4. 更新子模块：在仓库文件夹上点击右键，选择「TortoiseGit」→「子模块更新...」

冲突解决

当合并或拉取时遇到冲突：

1. TortoiseGit 会显示冲突文件列表
2. 双击冲突文件，TortoiseGit 会打开内置的冲突解决器
3. 在冲突解决器中，选择要保留的代码部分
4. 点击「保存」完成冲突解决
5. 提交冲突解决结果

历史记录查看

1. 在文件或文件夹上点击右键，选择「TortoiseGit」→「显示日志」
2. 在日志窗口中，可以查看提交历史、分支情况和文件变更
3. 可以通过「查看」菜单切换不同的日志视图模式
4. 可以右键点击提交记录，执行「重置」、「反向提交」等操作

7. 常见问题与解决方案

问题 1：右键菜单中没有 TortoiseGit 选项

解决方案：

• 检查是否正确安装了 TortoiseGit 和 Git
• 重启电脑以完成集成
• 确认 Windows 资源管理器没有使用第三方替代方案

问题 2：提交时出现「无法访问 git.exe」错误

解决方案：

• 在 TortoiseGit 设置中，检查「Git.exe 路径」是否正确
• 确认 Git 已正确安装
• 重新安装 Git，选择「添加到系统 PATH」选项

问题 3：推送失败，提示「权限被拒绝」

解决方案：

• 检查远程仓库 URL 是否正确
• 确认你有推送权限
• 检查 SSH 密钥是否正确配置（如果使用 SSH 协议）
• 检查用户名和密码是否正确（如果使用 HTTPS 协议）

问题 4：分支合并时出现冲突

解决方案：

• 使用 TortoiseGit 内置的冲突解决器解决冲突
• 手动编辑冲突文件，删除冲突标记，保留正确的代码
• 解决冲突后，重新提交合并结果

问题 5： TortoiseGit 界面显示乱码

解决方案：

• 确保安装了正确的语言包
• 在设置中切换到合适的语言
• 检查系统区域设置是否正确

8. 最佳实践

1. 定期提交：小而频繁的提交比大而少的提交更好
2. 写好提交信息：清晰、简洁地描述本次更改的内容
3. 使用分支：为不同功能或修复创建单独的分支
4. 定期拉取：保持本地仓库与远程仓库同步
5. 使用 .gitignore：忽略不需要版本控制的文件
6. 备份仓库：定期备份重要仓库
7. 学习 Git 命令：虽然使用 GUI，但了解基本的 Git 命令有助于解决复杂问题

9. 相关资源

• TortoiseGit 官方文档
• Git 官方文档
• Git 教程 - Pro Git 书籍

---

通过以上配置和使用指南，你应该能够充分利用 TortoiseGit 工具来管理你的 Git 仓库，提高版本控制的效率和可靠性。如果在使用过程中遇到其他问题，建议参考官方文档或社区论坛寻求帮助。