TortoiseGit 入门：从 Clone 到 Pull、Commit 和 Push

TortoiseGit 是 Windows 上的 Git 图形工具，主要通过资源管理器右键菜单操作，用来下载项目、获取更新、记录修改和上传提交。

Windows 11 如果看不到 TortoiseGit 菜单，先点击“显示更多选项”。除 Clone 外，以下操作通常都在项目根目录内右键进行。

1. 常用操作速查

菜单名称可能因语言包和版本略有不同，可以对照英文名称寻找。

2. 示例配置

以下使用示例仓库演示。操作时请替换成自己的仓库地址、目录和分支。

origin 是远端仓库的名称；分支是项目的一条开发路线。Pull 时应选择需要更新的分支，新内容发布在其他分支时，不会自动进入当前分支。

3. 第一次下载项目：Clone

1. 打开准备存放项目的父文件夹，例如 D:\Git。

2. 右键空白处，选择 Git Clone…。

3. 填写以下字段：

   字段	示例
   URL	https://example.com/team/project.git
   Directory（目录）	D:\Git\project
   Branch（分支）	要获取指定分支时，勾选并填写 main；留空则使用仓库默认分支
   其他选项	保持默认；如果项目说明要求初始化子模块，按要求启用 Recursive

4. 点击 OK，按提示完成账号认证。

5. 等待成功，打开目标目录检查项目文件。

目标目录应当不存在或为空。Clone 完成后，日常更新使用 Pull，无需重新 Clone。

官方说明：Clone

4. 获取别人提交的更新：Pull

1. 在项目根目录右键，选择 TortoiseGit → Check for modifications，检查是否有本地修改。

2. 如有需要保留但尚未提交的修改，先按第 5 节进行 Stash。

3. 右键，选择 TortoiseGit → Pull…。

4. 确认 Remote 为 origin，Remote Branch 为 main；其他选项保持默认。

5. 点击 OK，等待完成。

6. 如果之前使用了 Stash，拉取成功后恢复储藏。

常见结果：

• 成功 / Fast-forward：当前分支已更新。

• Already up to date：所拉取分支已经是最新。

• Conflict：存在冲突，需要处理后才能继续。

• Authentication failed：认证失败，按服务端要求重新登录。

可以通过 Show log 查看最新提交。Fetch 只获取远端信息，Pull 会进一步更新当前分支的文件。

官方说明：Pull 与 Fetch

5. 暂存本地修改：Stash

适合“修改还没做完，但现在需要拉取更新或切换分支”的情况。

1. 右键，选择 TortoiseGit → Stash changes。

2. 填写备注，例如“更新前保存本地设置”。

3. 如果还要暂存新建且未被 Git 跟踪的文件，勾选 Include untracked。

4. 点击确定，完成后再 Pull 或切换分支。

5. 需要恢复时，选择 TortoiseGit → Stash Pop。

Stash List 可以查看已有储藏；Stash Apply 恢复修改但保留储藏记录。恢复时如果出现冲突，需要处理冲突。

官方说明：Stash

6. 保存自己的修改：Commit

1. 修改项目文件。

2. 在项目根目录右键，选择 Git Commit → 当前分支。

3. 检查文件列表，双击文件查看差异。

4. 只勾选本次准备提交的文件；新文件勾选后也可以加入提交。

5. 填写清楚的提交说明，例如“修复配置读取错误”。

6. 点击 Commit。

Commit 将修改保存到本地 Git 历史中。上传这些提交需要再执行 Push。

提交前检查本机配置和构建输出。例如 .vscode/settings.json 可能包含本机工具路径，应确认是否适合共享。

官方说明：Commit

7. 上传自己的提交：Push

需要账号具有远端仓库的写入权限。

1. 完成 Commit。

2. 右键，选择 TortoiseGit → Push…。

3. 确认以下内容：

   字段	示例值
   Local Branch	main
   Remote Branch	main
   Remote	origin

4. 点击 OK，等待成功。

如果提示远端已有新提交导致推送被拒绝，先 Pull，处理冲突并检查结果，再 Push。不要用 Force 覆盖不清楚的远端改动。

官方说明：Push

8. 查看历史：Show log

1. 右键，选择 TortoiseGit → Show log。

2. 选择一条提交，查看作者、时间、说明和改动文件。

3. 双击改动文件，查看该次提交的差异。

在某个文件上右键打开 Show log，可以查看这个文件的修改历史。

官方说明：日志

9. 切换分支：Switch/Checkout

1. 先 Commit 或 Stash 当前需要保留的修改。

2. 如需发现远端新分支，先 Fetch。

3. 右键，选择 TortoiseGit → Switch/Checkout…。

4. 选择需要的分支。首次使用远端分支时，按对话框提示创建对应本地分支并启用 Track（跟踪）。

5. 保持 Overwrite working tree changes / force 未勾选，点击确定。

切换分支后，项目文件会随所选分支变化。初学时优先选择分支；检出单个提交或标签会进入“分离 HEAD”状态，继续开发前需要建立分支。

官方说明：Switch/Checkout

10. 日常流程

只下载更新，不修改代码

检查本地修改 → 必要时 Stash → Pull → 必要时 Stash Pop → 查看日志。

修改代码并上传

Pull → 修改和验证 → 检查差异 → Commit → Push。

常见问题处理

Git 管理的是仓库中被跟踪的文件。源码更新后，另行安装的软件不会自动升级；需要按项目的发布说明获取对应版本。