TRAE-AI编程
TortoiseGit 是 Windows 上最顺手的图形化 Git 客户端，日常提交主要靠右键菜单完成：改动后右键「Git Commit」写提交说明并勾选文件，推送到远程用「Push」，拉取别人改动用「Pull」。下面按三种高频场景讲清每一步该点哪里、预期看到什么、出错怎么处理。很多刚从命令行转过来的同学，总担心点错菜单把提交弄乱；其实 TortoiseGit 底层执行的就是标准 Git 命令，只要理清提交、推送、拉取三步，就能放心用图形界面。本文所有操作都基于 Windows 环境，macOS 与 Linux 请改用其他客户端。
先看结论
图形化提交的核心流程只有三步：在文件上右键「Git Commit」→ 勾选要提交的文件并写说明 → 点「Commit」完成本地提交；需要同步时用右键「Push」或「Pull」。和命令行相比，TortoiseGit 把状态、差异、冲突解决都做成了可视化界面，适合不熟悉命令行的同学，但底层仍然是标准的 Git 操作。从 Git 完整教程 的角度理解，它只是把 git commit / push / pull 包装成了菜单。
适用边界：TortoiseGit 只在 Windows 平台提供完整功能，macOS 与 Linux 上请改用其他图形化客户端或命令行。版本方面，本文以 2.15 以上版本为准，旧版本菜单文字可能略有差异，但提交、推送、拉取三步的位置长期稳定。命令细节可随时查 Git 命令速查 对照。
一、场景一：把本地改动提交到仓库
这是最常用的图形化提交场景。前置条件很简单：本机已安装 TortoiseGit，并且项目已经克隆（Clone）到本地。修改完代码后，在资源管理器里进入项目文件夹，在空白处或具体文件上点右键，选择「Git Commit -> "master"...」（分支名会随当前分支变化）。
在弹出的提交窗口里，左侧列出所有改动文件，勾选你要提交的文件，右下角填写提交说明，然后点「Commit」。预期结果（未在本机执行）：窗口底部提示「Success」，本地分支多了一条新提交。验证提交是否成功，可以看窗口里的文件图标——绿色对勾代表已提交，红色感叹号代表还有未提交改动。想深入理解背后的提交对象，可看 Git 进阶技巧 里的图解。
二、场景二：把提交推送到远程
本地提交完成后，别人还看不到你的改动，需要推送。前置条件是本地已有至少一个领先远程的提交。在项目文件夹右键选择「TortoiseGit」→「Push」，确认远程（Remote）通常是 origin、分支名正确，点「OK」。
性能与取舍：推送只上传本地领先远程的那几次提交，速度取决于改动量而非仓库总大小。失败处理：如果推送被拒绝，多半是远程已有新提交，先点右键「TortoiseGit」→「Pull」把别人的改动合并进来，解决可能的冲突后再重新 Push。注意保护分支通常会禁止强制推送，这属于仓库策略而非客户端设置，遇到拒绝不要强行改配置绕过。
三、场景三：拉取别人改动并解决冲突
日常协作里最常见的图形化提交后续动作是拉取。前置条件是你已经配置好远程地址。右键「TortoiseGit」→「Pull」，选择远程与分支后点「OK」，TortoiseGit 会把远程改动合并到本地。
如果同一行被两边改了，会弹出冲突提示。此时右键冲突文件选「Edit Conflicts」，TortoiseGit 的合并工具会并排展示「本地 / 合并结果 / 远程」三栏，你手动保留正确内容后点「Mark as resolved」，再完成一次提交即可。安全方面，合并前建议先 Commit 本地改动，避免未提交的编辑在拉取时被覆盖。验证合并是否干净：Pull 之后用「Show Log」检查提交链是否连续，没有重复或分叉。
四、新手最容易踩的三个坑
第一类错误是勾选了不该提交的文件（比如本地配置、日志）。在提交窗口取消勾选即可；如果已经提交，用「Show Log」找到该提交，通过「Revert」生成反向提交来抵消，不要直接去改历史。第二类错误是 Push 被拒后反复重试，却不先 Pull，结果冲突越积越多。正确顺序是先 Pull 合并、再 Push。第三类错误是忽略冲突提示，强行标记已解决，导致别人拉到半成品代码。验证时务必打开冲突文件确认三栏内容都已正确保留。
操作前的前置与验证清单
动手前先确认三件事，能省掉大多数返工。前置：本机已装 TortoiseGit、项目已 Clone 到本地、当前分支名称正确。操作：提交时勾对文件、写清说明；推送前确认远程是 origin、分支名无误。验证：Commit 后看窗口提示「Success」与文件图标变绿；Push 后到远程仓库页面确认提交已出现。失败处理：Push 被拒先 Pull 合并，冲突用合并工具三栏解决，再提交一次，不要强行覆盖。把这套前置与验证养成习惯，日常提交几乎不会出意外。另外，提交说明建议写成「动作 + 原因」的短句，例如「修复登录超时：补充重试间隔」，这样日后用 Show Log 回看提交改动时，不用点开 diff 也能明白每次提交的目的。
常见问题
Q：图形化提交和命令行提交，结果一样吗？
底层完全一致。TortoiseGit 的「Git Commit」执行的仍是标准 git commit，只是把参数做成了界面。团队里有人用命令行、有人用图形化客户端，提交记录能无缝互通。
Q：勾选文件时误选了不该提交的文件怎么办？
在提交窗口取消勾选即可；如果已经提交，可以用「TortoiseGit」→「Show Log」找到该提交，通过「Revert」生成反向提交来抵消，不要直接去改历史。
Q：Pull 之后出现大量冲突，怎么快速排查？
先用「Show Log」对比本地与远程的提交差异，定位是哪几次提交产生了冲突，再针对具体文件用合并工具逐个解决，解决完统一做一次提交。
总结
TortoiseGit 的日常图形化提交可以归纳为一句话：右键 Commit 写说明勾文件、右键 Push 传远程、右键 Pull 收改动。掌握这三种高频场景，配合 Show Log 与冲突合并工具，就能应付绝大多数 Windows 下的 Git 协作。命令行与图形化客户端只是入口不同，理解背后的提交、推送、拉取逻辑才是关键，版本控制能力不会因为换了界面就变弱。
