Sourcetree安装配置教程：从零到精通Git图形化操作

如果你正被 Git 命令行绕得头晕尤其是刚开始接触 Git 的那一两个月我强烈建议你先装一个 Sourcetree 试试。这是一款免费的 Git 图形化客户端支持 Windows 和 macOS也是很多老牌开发团队一直在用的工具。它把 clone、commit、push、pull、分支管理、合并冲突、历史回退这些操作都变成了鼠标点击不用背一堆 git 命令看分支图也一目了然。这篇教程我会带你从零开始走完整套 Sourcetree 安装流程再把安装后最容易踩的坑挨个拆掉包括“用户设置必须被修复”、ed25519 密钥配置、冲突解决、代码回到指定提交等等。只要你照着做基本能做到打开 Sourcetree 就能上手干活。1. Sourcetree 安装前先花两分钟做功课1.1 命令行 Git 已经够用为什么还要装一个“有界面的 Git”很多人最开始会觉得既然 Git 是标配那敲命令是不是更“专业”其实不是这么回事。命令行确实强大但成本也不低。比如你想看一个分支从哪分出来的、两个分支差了多少个提交、某个文件改动了几行命令虽然能看但效率确实不高。而 Sourcetree 这种 GUI 工具把这些信息全部画成图形打开就是一张清晰的分支图哪里分叉、哪里合并、哪个提交是谁干的几秒钟就能定位。换个角度看团队协作用 Git重点不只是操作而是让每个人都“看得懂”仓库发生了什么。Sourcetree 在这一点上做得非常直观尤其是给新人讲分支策略的时候直接在图上比划比在终端里敲git log --graph要清楚得多。这也是为什么很多公司里非资深开发者和前端同学反而更依赖 Sourcetree。另外Sourcetree 本身的“中文界面”支持也很成熟。虽然菜单里部分译名不算完美但相比一堆英文命令新手上手门槛低了很多。更关键的是它对 Windows 和 macOS 都很友好不存在“只有 Mac 才能用”的门槛跨平台体验一致。我之前帮人排查问题就是在不同的操作系统上装同一套 Sourcetree操作路径和界面几乎一样省了很多解释成本。1.2 下载前必须搞清楚的 3 件事我把下载前要准备的事情列一下避免你卡在半路又回去翻教程Git 本体到底要不要先装Sourcetree 在安装过程中会给你两个选择一是使用它的“嵌入式 Git”二是使用系统已经安装的 Git。如果你电脑里已经装了 Git我建议选“系统 Git”如果还没装那直接用嵌入式 Git 也能跑通但后续你要是想用命令行还是建议装一个独立的 Git。操作系统版本能不能对得上Sourcetree 官方对 Windows 10/11 和 macOS 都有对应安装包。下载之前先确认系统位数现在基本都是 64 位版本选最新的稳定版就行。Atlassian 账号到底要不要注册官网下载安装包之前会引导你登录或注册一个 Atlassian 账号。这个账号是免费的注册过程并不复杂用邮箱收个验证码就能搞定。你如果不想注册有些第三方下载站也能下到安装包但不推荐因为无法校验文件完整性风险不值得冒。千万别小看这 3 件事它们决定了你后续配置是不是一路顺畅。尤其是 Git 版本选择如果选错后面可能出现“嵌入式 Git 太旧”“Sourcetree 无法识别系统 Git”这类问题排查起来挺浪费时间的。2. Sourcetree 详细安装流程一步步照着做2.1 官网下载的正确姿势首先不要随便在搜索引擎里点一个“Sourcetree 下载”的广告链接尤其是带“高速下载”“破解版”字样的十有八九是坑。我建议你直接访问 Sourcetree 的官网域名是sourcetreeapp.com进入后页面会自动识别你的操作系统给出对应平台的最新版安装包。页面上的下载按钮会先带你去 Atlassian 账号登录页。没有账号就现场注册一个注册完重新点下载链接这时才会真正开始下载。这里有个小脾气官网的下载速度有时候不算快尤其在网络条件一般的时候文件不大但偶尔也会卡住。建议用浏览器的下载管理工具保持连接不要反复刷新页面否则容易触发重复下载弄出一堆-1.download后缀的残缺文件。下载完成后建议顺手看一下安装包名字Windows 一般长这样SourcetreeSetup-x64-版本号.exemacOS 是Sourcetree-版本号.dmg。如果文件大小明显小于正常标准删掉重新下载别强行安装否则后面大概率出莫名其妙的问题。2.2 Windows 系统安装全流程含每一步细节拿到安装包之后双击运行。如果你之前从没装过任何 Git 工具系统弹 UAC 权限确认时直接点“是”。进入安装向导后你会看到几个选项这里逐个说一下创建桌面快捷方式建议勾上后面你每天都要打开它放桌面方便很多。添加“从 Sourcetree 打开”到资源管理器右键菜单这个看个人喜好勾上之后你在文件夹里右键就能“Clone 到 Sourcetree”或“在 Sourcetree 中打开”。我自己是勾上的因为平时找仓库路径更快。如果你嫌右键菜单太乱不勾也没问题。Git 版本选择如果检测到系统已有 Git会默认选“系统 Git”如果没检测到会默认选“嵌入式 Git”。我前面说过优先系统 Git。但如果你是第一次装身边也没人指导选嵌入式 Git 也不是不行至少能先跑起来。要注意的是Sourcetree 的嵌入式 Git 版本更新频率不高后面如果遇到 Sourcetree 行为反常可以回到这里把嵌入式 Git 升级或切换为系统 Git。使用 System Git 后是否继续这一步可能出现一个提示意思是“使用系统 Git 需要跳过内置 Git 的注册”直接确认即可。安装过程中Sourcetree 可能还会弹一个“Mercurial”相关选项。Mercurial 是另一种版本控制工具跟 Git 不是一回事。我们这里主要用 Git不勾选也完全没关系。但如果你以后打算维护老旧的 Mercurial 仓库倒是可以勾上。我建议新手一律不勾少装一个组件就少一个坑。完成上面这些步骤后安装程序会在后台复制文件一般几十秒到一两分钟不等。看到“Setup was successful”之类的提示就算装完了。2.3 macOS 系统安装注意macOS 下从官网下载的.dmg文件双击挂载后会弹出一个窗口里面是一个 Sourcetree 图标和一个“Applications”文件夹的快捷方式。你只需要把 Sourcetree 图标拖进 Applications 文件夹就完成安装了。这一步没什么选择选项非常快。有一个常见问题首次点击打开 Sourcetree 时系统提示“无法打开因为它来自身份不明的开发者”。这是 macOS 的 Gatekeeper 安全机制。解决办法很简单去“系统设置 - 隐私与安全性”滚动到最后你会看到“仍要打开”的按钮点它然后再双击 Sourcetree 就能开了。以后再次打开就不会再问。macOS 版本的 Sourcetree 首次启动同样会要你登录 Atlassian 账号或者选择“在 Atlassian 注册账号稍后处理”。我这里建议如果你只是想快速试用可以先跳过后面要用到 Bitbucket 等托管服务时再补登录也不迟。3. 安装后的首次配置这几个设置决定你后面用得顺不顺3.1 “用户设置必须被修复”是绕不开的第一道坎很多人在 Windows 上第一次启动 Sourcetree 时会看到一个弹窗标题写着“用户设置必须被修复”下面可能还有一句“This file cant be edited”之类的话。我第一次看到这个弹窗也有点懵因为明明刚装完怎么就要修这个问题的根源是 Sourcetree 在每次启动时会读取一个用户配置文件user.config位置在%LocalAppData%\Atlassian\Sourcetree\user.config。如果这个文件被标记为只读、损坏或者因为之前强制断电、强制关闭程序导致写入中断Sourcetree 就会认为现有配置不可信要求你“修复”它。解决方案并不复杂我直接给你一套保守且安全的操作步骤先把 Sourcetree 完全退出包括系统托盘里的图标右键退出。按Win R输入%LocalAppData%\Atlassian\Sourcetree\回车。找到user.config先右键重命名成user.config.bak而不是直接删除。重命名可以让你反悔时还能恢复。重新打开 Sourcetree。此时它会生成一个新的默认user.config再走一遍首次配置流程。正常情况下重新生成后的 Sourcetree 就能正常进入主界面了。有一点要提醒你重命名 user.config 后你之前保存的账户信息、界面偏好会被重置需要重新登录一次 Atlassian 账号并重新配置用户名邮箱。这个代价完全可以接受毕竟比卡在启动界面强多了。如果重命名后还是弹“用户设置必须被修复”那大概率是权限问题。建议检查 Sourcetree 是否被安装了到C:\Program Files\Atlassian\Sourcetree这种需要管理员权限的目录然后右键 Sourcetree 图标选择“以管理员身份运行”再试一次。注意这种方式只是临时提权解决后不用一直用管理员身份跑。3.2 配置 SSH 密钥用 ed25519少走十年弯路Sourcetree 装好以后第一件事绝对不是急着 clone 仓库而是先把 SSH 密钥配好。否则后面 push 和 pull 都会反复弹密码烦到你怀疑人生。为什么要配 SSH因为 HTTPS 方式每次操作都要输入账号密码即便 Sourcetree 可以帮你记住密码但遇到公司强制要求 SSH 认证或者二次认证的时候还是 SSH 密钥最省事。再加上现在各大托管平台基本都支持 ed25519 格式的密钥不仅计算快安全性也足够好所以建议直接生成 ed25519 而不是老的 RSA 2048。生成密钥的命令很简单打开 Git BashWindows或终端macOS执行ssh-keygen -t ed25519 -C 你的邮箱 -f ~/.ssh/id_ed25519敲回车后系统会让你设置 passphrase口令短语。这里可以留空也可以设置一个。留空的好处是 Sourcetree 使用起来不需要每次输口令坏处是谁拿到你的私钥都能用。介于我们这是本机开发环境我给的建议是如果你只是个人电脑留空就行如果是公司电脑设一个也行因为 Sourcetree 会引导你通过钥匙串记住口令。生成之后你会得到两个文件id_ed25519私钥和id_ed25519.pub公钥。现在打开那个.pub文件把里面所有内容复制下来。登录你的 Git 托管平台找到 SSH Keys 或 Deploy Keys 设置粘贴保存。这一步是把“公钥”告诉平台而不是把私钥给任何人。接下来打开 Sourcetree点击顶部菜单“工具 - 选项 - 一般”往下找“SSH 客户端配置”SSH 客户端选择选OpenSSH不要选 PuTTY。除非你机器上以前用过 PuTTY 且一直用着否则 OpenSSH 和 ed25519 搭配最省心。SSH 密钥位置手动选择和前面生成的id_ed25519私钥文件不是.pub文件确认一下路径对不对。保存之后回到 Sourcetree 执行一次Clone仓库地址用 SSH 格式形如gitgithub.com:xxx/yyy.git。如果直接 clone 成功不用输密码说明 SSH 配置成功了。如果你在 Sourcetree 里 clone 时依然提示认证失败先别着急改配置大概率不是你设置错了而是 SSH agent 还没加载私钥。Windows 用户在 Git Bash 里执行eval $(ssh-agent -s) ssh-add ~/.ssh/id_ed25519macOS 用户则执行ssh-add --apple-use-keychain ~/.ssh/id_ed25519然后再回 Sourcetree 重新 clone。一般来说只要公钥贴对位置、私钥被 SSH agent 正确加载这个报错就消失了。3.3 账号信息与仓库克隆的首次设置SSH 配好后Sourcetree 还需要知道你是谁这样提交历史里才能正确显示作者信息。点击“工具 - 选项 - 一般”找到“用户信息”区域填上你的用户名和邮箱。这里的用户名不要求是托管平台账号名它可以是一个花名或英文名比如zhangsan邮箱务必填一个和你的 Git 托管账号匹配的邮箱。不匹配的话提交记录虽然也能产生但平台不会把它关联到你的账号头像后面统计工作量时会少算。然后我们来 clone 第一个仓库。回到 Sourcetree 主界面点“Clone”按钮弹出窗口里有几个字段源路径粘贴仓库 URLSSH 或 HTTPS 都行。目标路径选择你本地想要存放的目录。注意别选一个已经存在同名文件夹的目录否则会提示非空。名称Sourcetree 会自动按照仓库名填好一般不用改。点击“克隆”Sourcetree 会开始从远端拉取历史记录。如果仓库特别大分支特别多这里要等一会儿界面可能会短暂卡住属正常现象。等左下角不再显示进度条仓库基本就克隆好了。克隆完成后你会看到分支图、当前分支的“主分支master 或 main”。在左侧“文件状态”面板里你能看到工作副本的状态、暂存区、提交输入框这套界面就是后面日常操作的主战场。4. 高频操作场景与问题排查实录4.1 合并冲突的解决思路搞懂一次以后都会了用 Git 做开发合并冲突几乎是躲不掉的。Sourcetree 处理冲突的核心逻辑比命令行要友好太多因为冲突文件会被单独标记出来不会像命令行那样靠提示去猜。先说冲突长什么样子。当你执行 Pull 或者 Merge 后如果某个文件同时被两个分支的不同提交修改了Sourcetree 的文件状态面板里会出现“未合并”或带惊叹号的文件列表。点开这个文件你能看到文件内容里夹杂着这样的标记 HEAD 这里是你当前分支的内容 这里是另一个分支的内容 feature/xxx这就是冲突标记。 HEAD表示分隔线前面的是当前分支的版本 feature/xxx表示分隔线后面的是将要合并进来的目标分支的版本。你需要做的就是打开文件把标记和多余内容清掉保留你想留下的代码然后保存。在 Sourcetree 里解决冲突的推荐路径是右键点击冲突文件选择“解决冲突”然后选择“打开外部合并工具”或“手动合并”。如果你本机装了 Beyond Compare、Kaleidoscope 这类合并工具Sourcetree 会自动调用它左右两栏对比非常直观。如果你不想装外部工具也可以直接选“手动合并”Sourcetree 会自动把冲突标记高亮方便你逐个编辑。我建议你在解决冲突时遵循一个顺序先看HEAD的内容再看对方分支的内容最后想清楚“两边的改动到底哪个是对的”。这不是技术问题而是业务问题。有时候两边代码逻辑都要保留有时候只需要取一边关键是别随手把所有冲突标记删掉了事。冲突解决完毕后回到 Sourcetree 文件状态面板右键点击该文件选“标记为已解决”。此时文件才会重新出现在暂存区里你才能正常提交。完成提交后合并流程才算真正结束。这里有一个我踩过几次的坑解决冲突时不要先点“放弃我的修改”或“放弃对方修改”。这两个选项看起来省事实际是直接把某一方的整个文件覆盖掉如果那个文件里既有你改的代码又有对方改的代码一覆盖全都没了。宁可手动逐段处理也别偷懒。4.2 代码回到指定提交三种方式分清楚热搜词里有一条叫“代码回到指定一次提交”这其实是 Sourcetree 里被问得最多的操作之一。很多人提交后悔了想回到几天前的某个提交状态但又怕把历史搞乱。这里我把常用方式讲清楚。在 Sourcetree 的分支图上找到你想回到的那个提交右键它你会看到几个关键词Reset main 到这此提交、Cherry Pick、Reverse 提交。对于“回到指定提交”这个需求大部分人应该用Reset main 到这此提交。点开它后Sourcetree 会弹出三种模式这是整个操作里最关键的一步Soft软重置分支指针移动到目标提交但工作区、暂存区里你的改动全部保留。意思是“我回到那个提交但刚才改的东西还在可以重新提交”。想重新整理提交历史时这个最常用。Mixed混合重置指针移动工作区保留暂存区被清空。改动还在但全部变成“未暂存”状态。适合你想重新挑选部分文件提交的场景。Hard硬重置指针移动工作区、暂存区全部被目标提交覆盖任何后加的改动都会被丢弃。这是危险系数最高的一项用之前务必确认你不需要保留手头未提交的内容。选择模式后点击确定Sourcetree 会对本地执行对应的git reset。这里要特别说明一个问题如果你已经把后续这些提交 push 到了远程分支重置之后本地分支和远程分支就不一致了。比如你 reset 回旧提交但远程远端还停留在新提交此时再点 PushSourcetree 会提示“远程拒绝更新”。解决办法是在 Push 面板勾选“强制推送”或“Force Push”。但请注意强制推送会改写远程分支历史如果这个分支上还有其他同事在开发别人的本地历史会和远程对不上会造成一连串问题。所以“强制推送”的适用场景是这个分支是你个人的功能分支或者团队明确同意你重置历史。否则不要强推。如果你只是想撤销某一个提交造成的影响但不想改动历史顺序那就用Reverse 提交相当于git revert。它是建立一个“反向提交”把之前那次提交的改动抵消掉历史完整保留对多人协作更友好。我的建议是只在本地还未推送时用 Reset已经推送后优先用 Reverse 提交。4.3 常见问题速查表直接对号入座我在给团队配置 Sourcetree 的过程中总结过一张速查表现在分享给你。遇到问题先查表比抓瞎折腾省很多时间。现象可能原因处理方式启动时反复提示登录Atlassian 账号未配置好工具 - 选项 - 认证 - 添加账号重新登录Clone 远程仓库一直要密码未配置 SSH 密钥参考第 3.2 节生成并配置 ed25519 密钥文件状态面板空白看不到改动嵌入式 Git 版本过旧或损坏工具 - 选项 - Git更新/切换为系统 GitmacOS 无法打开 SourcetreeGatekeeper 拦截系统设置 - 隐私与安全性 - 仍要打开Push 被拒绝远程历史与本地不一致确认是否需要合并远程改动避免直接强推中文文件名或提交信息乱码编码设置不一致工具 - 选项 - Git - 点击“更新嵌入式 Git”并设置 encoding 为 UTF-8Pull 时提示“请先提交或暂存”本地有未提交改动且与远端冲突先提交或暂存本地改动再 pull分支图看起来太乱线绕来绕去未定期同步远程更新点击“拉取”按钮获取最新远程引用开启“获取所有仓库的更新”仓库很大Sourcetree 卡顿明显单仓库历史量大不要默认加载所有历史可考虑使用--depth方式有限克隆5. 装完 Sourcetree 后的实战建议与使用习惯5.1 别急着删命令行和 Sourcetree 配合用我见过一些新手装完 Sourcetree 就好像找到了避风港命令行一律不用。说实话这也不是最优解。Sourcetree 虽好但在某些场景下反而不如命令行快比如批量分支操作、交互式 rebase、临时查看文件某一行由谁修改命令行更顺手。我的用法是日常看分支图、提交改动、处理冲突、回退提交都用 Sourcetree涉及批量重命名分支、复杂 rebase 策略、命令无法在 GUI 里直接表达的操作再回到终端。两者互补不要觉得用了 GUI 就不算专业也不要觉得 Sourcetree 是“新手工具”。它能大幅降低 Git 的上手难度让团队协作更顺畅这对项目本身才更重要。实际项目里我给团队定的规范是提交前先在 Sourcetree 里过一遍 diff确认没有误提交敏感信息合并分支前看一眼分支图确认目标分支没有落后太多。这比事后猛敲git log找原因高效得多。5.2 配置一个“自定义操作”提升日常效率Sourcetree 的系统级功能里有一个容易被忽略的好东西自定义操作Custom Actions。它可以让你在右键菜单里添加自己写的脚本比如一键执行npm test、一键格式化代码、一键清除本地多余分支。我自己就在右键菜单里加了一条“Run Test”选中提交或分支后直接执行测试脚本省得来回切终端。设置路径是工具 - 选项 - 自定义操作 - 添加。填写菜单名称、执行脚本的命令和参数。比如菜单名称Run Tests要执行的可执行文件cmd或/bin/bash看你系统而定。参数/c npm test或-c npm test这个功能有点像给 Sourcetree 装了快捷启动器花十分钟配置一次后面天天受益。5.3 最后再分享一个小技巧Sourcetree 的分支图默认是“按时间排序”但多人协作时我更习惯把视图切到“按拓扑排序”这样分支线会更清晰不会出现一条横跨整个界面的长线。切换位置在工具栏的“分支图”下拉菜单里找到“排序方式”改成“拓扑”就行。另外如果你发现 Sourcetree 在某个仓库里突然不显示任何文件变化但文件确实改动了先别急着重装。看看仓库路径里是不是有“符号链接”或者“子模块”Sourcetree 对这两类的支持一直是弱项。子模块需要单独在 Sourcetree 里初始化符号链接则经常被误伤。遇到这种项目改用git status确认一下状态再用git add处理往往比在 GUI 里耗着更明智。从我个人的经验看Sourcetree 并不是一个“功能到底有多强”的工具而是“让你不被 Git 折腾”的工具。安装和配置过程虽然有几个小坑但只要你照着这篇教程把用户配置、SSH 密钥和回退逻辑搞明白日常项目管理基本就是点几下鼠标的事。希望这篇教程能帮你顺利跑起来省下时间去处理真正要紧的代码问题。