1. 为什么我至今还在用 SourceTree 管理 Git 仓库
刚入行那会儿，团队里清一色推荐命令行操作 Git，理由是"显得专业"。我硬着头皮敲了小半年的git status、git diff、git log，直到有一次在紧急修 bug 时手滑执行了错误的回滚命令，把同事半天的提交记录搅得一团乱。那次事故之后，我开始认真研究图形化 Git 客户端，最终锁定了 SourceTree。它免费、跨平台、对 Git 和 Mercurial 都有原生支持，最关键的是——可视化地展示分支拓扑和文件差异，能让我在动手之前先看清楚"这一刀切下去会发生什么"。
这篇内容就是把我这些年用 SourceTree 的完整流程梳理出来，从下载安装、SSH 密钥配置、关联 GitHub 远程仓库，到日常提交、分支管理、冲突解决、回退到指定提交，全部走一遍。适合刚接触版本控制的新手，也适合用惯了命令行但想找个可视化工具辅助 review 的老手。我会把每一步的操作意图和踩过的坑都讲清楚，你照着做基本不会卡住。
2. 安装前的环境准备与工具选型
2.1 Git 内核必须先装好
SourceTree 本质上是一个 Git 的图形化外壳，它自己不包含 Git 内核。所以第一步永远是先把 Git 装到系统里。Windows 用户去 Git 官网下载安装包，一路默认选项即可，但有一个地方要注意：在"Adjusting your PATH environment"这一步，建议选"Git from the command line and also from 3rd-party software"，这样 SourceTree 才能自动检测到 Git 的可执行文件路径。如果选了"Use Git from Git Bash only"，SourceTree 安装后可能会提示找不到 Git。
macOS 用户更简单，打开终端执行git --version，如果系统提示安装命令行开发者工具，点确认等它装完就行。或者用 Homebrew 执行brew install git，版本会更新一些。
安装完成后，在终端或 CMD 里验证一下：
git --version # 输出示例：git version 2.43.0.windows.1看到版本号就说明 Git 内核就绪了。这一步看似简单，但我见过太多人跳过验证直接装 SourceTree，结果卡在"未找到 Git"的报错上反复重装。
2.2 SourceTree 下载渠道的选择
SourceTree 官网现在归属 Atlassian 旗下，直接搜索"SourceTree"进入官网下载页即可。Windows 版和 macOS 版都有，下载后双击安装，过程没什么特别的。有一点需要留意：安装过程中会要求登录 Atlassian 账号，这个账号可以免费注册，登录后 SourceTree 才能正常激活使用。如果你不想登录，可以跳过，但部分功能会受限，建议还是注册一个，两分钟的事。
注意：网上有一些第三方站点提供的"绿色版"或"破解版"SourceTree，强烈不建议使用。这类版本可能被植入恶意代码，而且无法正常接收更新，出了问题很难排查。
2.3 PuTTY 与 SSH-Key 的关系
热词里频繁出现 PuTTY，这里解释一下它在 SourceTree 生态里的角色。SourceTree 在 Windows 上默认使用 PuTTY 作为 SSH 客户端来与远程仓库通信。也就是说，你的 SSH 密钥需要通过 PuTTYgen 生成，并且以.ppk格式保存，SourceTree 才能识别。如果你用的是 Git Bash 自带的ssh-keygen生成的密钥（通常是id_rsa和id_rsa.pub），SourceTree 也能用，但需要在设置里把 SSH 客户端从 PuTTY 切换为 OpenSSH。
两种方式我都试过，PuTTY 方案在 Windows 上更"原生"，SourceTree 的页面集成度更高；OpenSSH 方案的好处是密钥格式通用，和命令行、其他工具共享同一套密钥。新手建议直接用 SourceTree 内置的 PuTTYgen 工具生成密钥，省去格式转换的麻烦。
3. SSH 密钥生成与 GitHub 关联配置
3.1 用 PuTTYgen 生成密钥对
打开 SourceTree，点击菜单栏"工具"→"选项"→"一般"，在"SSH 客户端配置"区域可以看到"SSH 密钥"的设置项。点击"生成密钥"按钮，会弹出 PuTTYgen 窗口。
操作步骤：
- 点击"Generate"按钮，然后在窗口空白区域随意移动鼠标，进度条会随着鼠标移动而增长。这一步的原理是利用鼠标移动的随机性来生成足够熵值的密钥。
- 进度条走完后，你会看到公钥内容显示在上方文本框里，私钥需要点击"Save private key"保存为
.ppk文件。建议保存到一个固定目录，比如C:\Users\你的用户名\.ssh\下，命名为github_rsa.ppk。 - 公钥内容先复制出来，待会儿要粘贴到 GitHub 上。
提示：PuTTYgen 会问你是否要在没有密码的情况下保存密钥，个人开发机可以选"是"，省去每次推送都要输密码的麻烦。但如果是共用电脑或对安全要求高的场景，建议设置一个 passphrase。
3.2 把公钥添加到 GitHub
登录 GitHub，点击右上角头像→"Settings"→左侧栏"SSH and GPG keys"→"New SSH key"。Title 随便填一个能识别的名字，比如"我的工作电脑"，Key 类型保持"Authentication Key"，然后把刚才复制的公钥内容粘贴进去，点击"Add SSH key"。
验证是否配置成功，可以在 SourceTree 里点击"工具"→"选项"→"一般"→"SSH 密钥"旁边的"测试连接"按钮（部分版本在"远程仓库"设置里）。如果看到"成功"提示，说明密钥已经生效。
如果测试失败，常见原因有两个：一是公钥粘贴时多了换行或空格，二是 PuTTY 的私钥文件路径没有在 SourceTree 里正确指定。回到"选项"→"一般"，确认"SSH 密钥"字段指向了你保存的.ppk文件。
3.3 备选方案：使用 OpenSSH 密钥
如果你已经有id_rsa密钥，或者想和命令行共用一套密钥，可以在 SourceTree 的"选项"→"一般"里，把"SSH 客户端"从 PuTTY 改为 OpenSSH。然后确保id_rsa文件放在~/.ssh/目录下（Windows 是C:\Users\你的用户名\.ssh\）。
这种方式的优点是密钥格式通用，缺点是 SourceTree 对 OpenSSH 的集成不如 PuTTY 那么顺畅，偶尔会出现"Permission denied"的报错。遇到这种情况，检查一下id_rsa文件的权限，Windows 上右键属性→安全→高级，确保只有当前用户有读取权限。
4. 关联远程仓库与日常操作全流程
4.1 克隆 GitHub 仓库到本地
SourceTree 主界面点击"克隆/新建"，在弹出的窗口里填入 GitHub 仓库的 SSH 地址（形如git@github.com:用户名/仓库名.git），选择本地保存路径，点击"克隆"。
这里有个细节：如果你在 GitHub 上看到的是 HTTPS 地址（https://github.com/...），需要手动切换成 SSH 地址。GitHub 仓库页面点击"Code"按钮，选择"SSH"标签页，复制那个地址。
克隆过程中如果卡住不动，大概率是网络问题。GitHub 在国内的访问确实不太稳定，可以尝试以下方案：
- 使用 GitHub 的镜像站点进行克隆，比如将
github.com替换为hub.fastgit.org或gitclone.com等镜像域名（注意镜像站可用性会随时间变化，需要自行验证）。 - 在 SourceTree 的"工具"→"选项"→"网络"里配置代理（如果你有可用的网络代理服务）。
- 使用 Gitee 作为中转：先把 GitHub 仓库导入到 Gitee，再从 Gitee 克隆到本地，推送时再推回 GitHub。
4.2 日常提交的完整操作
克隆完成后，SourceTree 主界面会显示仓库的提交历史、分支列表和工作区状态。日常开发流程大致如下：
- 拉取最新代码：点击工具栏的"拉取"按钮，选择远程分支，把服务器上的最新提交同步到本地。养成每次开始工作前先拉取的习惯，能避免很多不必要的冲突。
- 修改文件：在编辑器里改代码，保存后回到 SourceTree，工作区会自动显示有变更的文件列表。
- 暂存变更：勾选要提交的文件，点击"暂存"（或直接勾选文件前的复选框）。SourceTree 支持按行暂存，如果你只想提交某个文件里的部分改动，可以双击文件进入差异视图，选中要提交的行，右键"暂存选中的行"。
- 填写提交信息：在下方文本框写清楚这次提交做了什么，点击"提交"按钮。提交信息建议遵循"动词+对象+原因"的格式，比如"修复登录页面在移动端的布局错位问题"。
- 推送：点击工具栏的"推送"按钮，选择目标远程分支，确认后推送到 GitHub。
注意：提交（Commit）和推送（Push）是两个不同的操作。提交只是把变更记录到本地仓库，推送才是同步到远程服务器。很多人第一次用的时候只提交不推送，然后疑惑为什么 GitHub 上看不到更新。
4.3 分支管理与合并策略
SourceTree 的分支管理是我最喜欢的功能之一。左侧栏的"分支"区域会列出所有本地和远程分支，右键任意分支可以执行检出、合并、删除、变基等操作。
创建新分支的流程：点击工具栏"分支"按钮→输入分支名→选择基于哪个分支创建→点击"创建分支"。分支命名建议用"feature/功能名"或"fix/问题描述"的格式，团队协作时一目了然。
合并分支时，SourceTree 会可视化地展示合并结果。如果两个分支没有冲突，直接合并即可；如果有冲突，SourceTree 会进入冲突解决模式，把冲突文件标记出来，你可以选择"使用我的版本"、"使用对方的版本"或手动编辑解决。手动解决后，把文件标记为"已解决"，然后提交合并结果。
4.4 回退到指定提交的两种方式
热词里有人搜"sourcetree 代码回到指定一次提交"，这个需求很常见。SourceTree 提供了两种回退方式：
方式一：重置（Reset）
右键目标提交→"重置当前分支到此次提交"→选择模式：
- 软重置（Soft）：保留所有变更，只是把 HEAD 指针移过去。适合"我想重新组织最近几次提交"的场景。
- 混合重置（Mixed）：保留工作区变更，但清空暂存区。默认选项，适合"我想重新选择要提交的文件"。
- 硬重置（Hard）：丢弃所有变更，工作区完全回到目标提交的状态。这个操作不可逆，执行前务必确认没有未提交的重要改动。
方式二：还原（Revert）
右键目标提交→"还原提交"。这种方式会创建一个新的提交来抵消目标提交的变更，历史记录保留完整，适合已经推送到远程仓库的情况。团队协作中，如果某个提交已经推送且其他人可能已经拉取，用 Revert 比 Reset 更安全。
5. 常见问题排查与避坑经验
5.1 连接 GitHub 失败的排查思路
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| 克隆时提示"Connection timed out" | 网络无法访问 GitHub | 尝试镜像站点或配置网络代理 |
| 推送时提示"Permission denied (publickey)" | SSH 密钥未正确配置 | 检查 SourceTree 的 SSH 密钥路径，重新测试连接 |
| 提示"Host key verification failed" | 首次连接未确认主机指纹 | 在终端执行一次ssh -T git@github.com确认 |
| 克隆速度极慢 | 网络带宽或路由问题 | 使用 Gitee 中转或镜像站点 |
5.2 提交信息写错了怎么改
如果最后一次提交的信息写错了，还没推送，可以在 SourceTree 里右键该提交→"修改最后一次提交"（或使用git commit --amend），修改信息后确认即可。如果已经推送了，需要强制推送（Force Push），但这会覆盖远程历史，团队协作中要谨慎使用。
5.3 误删分支或误重置后的恢复
SourceTree 有一个"回收站"功能，右键仓库→"回收站"，可以看到最近删除的分支和提交。如果误操作后及时发现，可以从这里恢复。另外，Git 的 reflog 记录了 HEAD 的所有移动历史，在终端执行git reflog可以找到丢失的提交哈希，然后用git reset --hard 哈希值恢复。
5.4 SourceTree 卡顿或界面异常的解决
用久了 SourceTree 偶尔会变得很卡，尤其是仓库提交历史很长的时候。解决方法：
- 清理仓库的 reflog：
git reflog expire --expire=now --all && git gc --prune=now - 在 SourceTree 设置里关闭"自动刷新"或降低刷新频率
- 如果界面显示异常，删除 SourceTree 的配置文件目录（Windows 在
%APPDATA%\Local\Atlassian\SourceTree，macOS 在~/Library/Application Support/SourceTree），重启后会重新生成
5.5 关于 GitHub 访问的实用建议
GitHub 在国内的访问体验确实不稳定，这是客观事实。除了前面提到的镜像站点方案，还可以：
- 使用 Gitee 作为主要远程仓库，GitHub 作为备份。SourceTree 支持同时配置多个远程仓库，推送时可以一次推送到两个地方。
- 对于开源项目，可以定期用
git fetch拉取更新，而不是每次都完整克隆。 - 如果只是查看代码，GitHub 的网页版通常比克隆更流畅。
6. 我这些年用 SourceTree 的一些个人习惯
用 SourceTree 这么多年，有几个习惯我觉得挺有价值，分享出来供参考。
第一个是提交前必看差异。SourceTree 的差异视图做得很直观，我每次提交前都会双击每个文件，确认改动符合预期。这个习惯帮我拦下过好几次误改的配置文件。
第二个是善用"搁置"功能。SourceTree 的"搁置"（Shelve）可以把当前未提交的变更临时存起来，工作区恢复到干净状态。当你需要紧急切换分支修 bug，但当前改动又不想提交时，这个功能特别好用。恢复时点击"取消搁置"即可。
第三个是给常用操作设置快捷键。SourceTree 支持自定义快捷键，我把"拉取"设为Ctrl+Shift+P，"推送"设为Ctrl+Shift+U，日常操作效率提升不少。
第四个是定期清理本地分支。远程分支删除后，本地还留着对应的追踪分支，时间长了列表会很乱。在 SourceTree 里右键远程分支→"删除追踪分支"即可清理。
最后说一个我踩过的坑：SourceTree 的"丢弃"（Discard）操作是不可逆的，右键文件→"丢弃"会直接还原到上次提交的状态，没有任何确认提示。我有一次手滑丢弃了一个还没提交的新文件，直接没了。所以现在我对"丢弃"按钮特别谨慎，重要改动一定先提交或搁置。
SourceTree 说到底只是一个工具，核心还是理解 Git 的工作模型——工作区、暂存区、本地仓库、远程仓库这四层结构，以及提交、分支、合并、变基这些基本操作的含义。工具帮你把操作可视化了，但决策还是得自己做。把底层逻辑搞清楚了，用 SourceTree 还是命令行，其实都差不多。
