Sourcetree 技术文档:介绍 · 下载 · 安装 · 使用(完整指南)

Sourcetree 技术文档:介绍 · 下载 · 安装 · 使用(完整指南) Sourcetree 技术文档介绍 · 下载 · 安装 · 使用完整指南摘要本文是Sourcetree的完整技术指南涵盖下载安装、核心功能及问题解决。主要内容包括1Sourcetree作为Atlassian开发的免费Git图形化工具能简化分支管理、提交等操作2支持Windows/macOS双平台提供可视化的提交树和文件状态展示3详细介绍了克隆仓库、分支管理、冲突解决等核心功能4包含性能优化、外部工具配置等进阶内容5解答了账号登录、中文乱码等常见问题。文章强调Sourcetree适合Git新手快速上手同时满足专家级操作需求是Atlassian生态团队的理想选择但也指出其在大型仓库性能方面的局限。一、前言Git 已经成为现代软件研发的基础设施但git checkout、git rebase -i、git merge --no-ff这类命令对新手并不友好——记错一条就可能把一天的工作搞丢。Atlassian 推出的Sourcetree​ 正是为了解决这个问题把 Git 的分布式版本控制能力装进一个图形界面让看分支图、点按钮提交、拖拽合并成为日常同时保留专家级功能interactive rebase、cherry-pick、submodule、Git LFS、git-flow。本文从这是什么讲到怎么用透覆盖 Windows / macOS 双平台目标是一份能让新人当天上手、老人也能查漏补缺的参考手册。二、Sourcetree 概述2.1 基本信息项目说明开发商AtlassianBitbucket 同门许可证免费个人/商用均可支持系统Windows 10/1164-bit、macOS 10.15 Catalina 及以上后端引擎Git主力 Mercurial遗留支持可取消安装最新稳定版2026Windows v3.4.31 / macOS v4.2.16官网Sourcetreeapp数据来源官网与 2026 年 6 月更新日志。2.2 它解决什么痛点命令行门槛git status→ 红黄绿一堆符号新手要反应几秒Sourcetree 用颜色 图标直接告诉你这文件是新增 / 修改 / 冲突。分支关系看不见纯命令行git log --graph还是文本Sourcetree 左侧 DAG 图一眼看出谁从谁分出去、合并没合干净。危险操作有后悔药误reset --hard前至少能在界面看到提交树revert / 软重置 / 硬重置三种模式可选比盲敲安全。团队协作对齐review changesets、cherry-pick 跨分支摘提交、stash 暂存半成品——这些专家动作 GUI 里点两下就行。2.3 与同类工具对比顺带说下什么时候不选它维度SourcetreeGitKrakenGitHub Desktop纯命令行价格免费个人免费Pro 付费免费免费平台Win/MacWin/Mac/LinuxWin/Mac/Linux 有限全平台Git-flow 内置✅ 开箱✅❌需额外装子模块✅ 可视化✅弱✅交互式 rebase✅✅ 很强❌✅ 最强启动速度中等Electron 架构偏重偏重轻快—大型仓库10万提交偶卡可调同快最快 选型建议如果你在 Atlassian 体系Bitbucket JiraSourcetree 是天然搭配如果是超大型单体仓库 Linux 主力机命令行 lazygit 可能更顺。三、下载3.1 官方入口认准这一个别下到捆绑版官网首页Sourcetreeapp—— 打开会自动识别系统点Download free​ 即可。历史版本归档老 macOS 或要锁版本时用Sourcetreeapp/download-archivesWindows 离线安装包官网默认是在线安装器想要离线 standalone exe 可以去 Atlassian 官方 release 页拉第三方如 offlineinstallersetup 也给直达链接但仍建议回官网核验 hash。3.2 系统要求速查WindowsOSWindows 10 / 1164-bit运行时.NET Framework 4.7.1安装器缺了会弹窗让你点链装内存2 GB 最低4 GB 推荐磁盘500 MB 空闲CPU1 GHz 64-bit 以上macOSmacOS 10.15 Catalina 及以上4.2.x 系列 Release Notes 明确标注4 GB 内存推荐M 芯片原生运行无问题⚠️ Windows 侧如果公司镜像是精简版很多 .NET 组件被砍装 Sourcetree 会卡在正在下载 .NET那一步——提前把 .NET 4.8 跑一遍能省半小时。四、安装与首次配置含避坑下面分 Win / Mac 讲共通流程坑点用 ⚠️ 标出这些是网上教程最容易一笔带过、但实际卡人的地方。4.1 Windows 安装步骤双击SourceTreeSetup.exe许可协议 Next。自定义组件页关键✅ 勾Git必选版本管理本体❌取消 Mercurial99% 团队只用 Git勾了多装几十 MB 还容易出诡异 bug选安装路径默认 C:\Users你\AppData\Local\SourceTree也行改 D 盘亦可。Install → Finish首次启动进入初始化向导。4.2 macOS 安装步骤下载.dmg拖进 Applications。首次打开若提示无法验证开发者去 系统设置 → 隐私与安全 → 仍要打开。同样进入初始化向导。4.3 首次启动的三道关关一Atlassian 账号登录弹窗问你要不要登 Bitbucket / Atlassian 账号——直接点Skip跳过。不影响任何核心功能本地 Git、SSH、克隆推送全都能用。后面真要绑 Bitbucket/Jira再从Tools → Options → Accounts加也不迟。关二Git 引擎选择Sourcetree 会问用哪种 GitEmbedded Git嵌入式安装器自动下版本由 Sourcetree 管最稳新手首选。System Git你机器上已choco install git/ 官网装过 Git 的可以选这个版本你自己升。 推荐第一次用直接 Embedded避免我 Git 装在哪了的灵魂拷问。关三SSH 与用户签名SSH 密钥新手先点否后面克隆仓库时再配老手把~/.ssh/id_rsa或 ed25519 指过去就行。用户名 / 邮箱必填填你 Git 服务商GitHub/GitLab/Bitbucket注册的那个Sourcetree 会写到~/.gitconfig等价于命令行git config --global user.name/email。4.4 中文乱码预防Windows 老问题如果仓库里有中文文件名装完建议顺手设一下工具 → 选项 → Git → 勾使用系统 Git的前提下在全局配置加git config --global core.quotepath false git config --global gui.encoding utf-8否则 Sourcetree 文件列表里中文会变成\344\275\240那种转义看着头疼。五、核心使用篇重点占篇幅最大Sourcetree 的功能按日常开发流组织比按菜单组织更好懂。下面按克隆 → 改代码 → 提交 → 分支 → 远程 → 冲突 → 回退 → 高级​ 八段走。5.1 克隆远程仓库第一天必做操作路径顶部Clone按钮 → 填三项Source URLgitgithub.com:your-org/project.git或 HTTPS 地址Destination Path本地想放哪选个空目录Sourcetree 会自动git clone进去Name书签显示名随意点 Clone等进度条走完左侧书签列表就多了一项双击进仓库主界面。 等价命令git clone url path小技巧如果登陆了 GitHub/GitLab/Bitbucket 账号Clone弹窗里能直接浏览你有权限的仓库列表不用去网页抄 URL。5.2 主界面布局先认一遍进仓库后界面大致分五块Win/Mac 布局一致┌─────────────── ① 顶部工具栏Pull / Push / Branch / Commit / ... │ ② 左侧栏 ③ 中央提交树DAG 图 ④ 右侧 Diff 区 │ - 分支列表 - 每条提交hash / 作者 / 时间 / 消息 │ - 远程 (origin) - 当前 HEAD 箭头、分支色点 │ - 标签 ⑤ 下方文件状态区Unstaged / Staged │ - Stashes - 红未跟踪 黄修改 绿暂存 └───────────────花 30 秒记住② 管切分支去哪③ 管看历史⑤ 管今天改了啥④ 管改了哪几行。5.3 文件状态 → 暂存 → 提交改完src/index.jsSourcetree 会自动刷出⑤ 区文件名变黄modified。提交流看 diff单击文件名④ 区显示红-绿行。部分暂存很香的功能点文件名旁小箭头 →Stage Hunk暂存这一块或Stage Line暂存这一行。不用git add -p也能挑着交。全暂存Stage All按钮或勾文件前复选框。写 commit message底部文本框建议语义化格式feat: 新增微信登录回调处理 fix: 修复分页器在 Safari 下溢出点Commit⌘/Ctrl Enter。 等价命令git add -p/git commit -m feat: ...5.4 分支管理Sourcetree 最强项之一创建分支Branch按钮 → 输入名字 → 选基准默认当前 HEAD。命名习惯功能feature/xxx修 bugbugfix/xxx或hotfix/xxx发布release/v1.2.0切换分支左侧 ② 栏分支列表 →双击目标分支。等价于git checkout branch。合并分支先切到接收方分支比如main右键待合并分支比如feature/login→Merge feature/login into main无冲突 → 自动出一条 merge commit有冲突 → 进 5.6 节Sourcetree 还支持把分支拖到另一个分支上触发合并视觉党会喜欢。删除分支合并完的feature/*没用了右键 →Delete远程分支同理但要勾tracked branch才会连远端一起删。5.5 远程同步Pull / Push / Fetch按钮等价 git场景Fetch​git fetch origin悄悄拉远端信息不动你本地代码先看同事推了啥Pull​git pull( fetch merge)开工前先拉避免后面 push 被拒Push​git push origin branch提交完推上去新分支第一次推会弹Set upstream记得勾⚠️强制推送Force Push默认关着要在工具 → 选项 → Git里手动开。开了也建议用--force-with-leaseSourcetree 4.2.7 已支持该选项比裸--force安全——别人刚在你之上推了提交lease 会拒绝避免覆盖。5.6 冲突解决新人最怕的环节冲突一般发生在Pull或Merge时Sourcetree 会把冲突文件标红状态写Conflicted。Sourcetree 内置解法单击冲突文件 → ④ 区显示 HEAD// branch标记编辑文件保留想要的那段删掉标记右键文件 →Mark Resolved提交这次 merge更爽的解法——外置 Merge Tool工具 → 选项 → Diff里把External Diff / Merge指向Beyond Compare / Meld / Araxis Merge冲突时右键Resolve Using 工具名三窗格点点点比手写快三倍。5.7 标签Tag管理发版本打v1.3.0这种 tag右键某条提交 →Tag...→ 输v1.3.0可加 annotation推到远端Push按钮 → 勾Include tags默认不勾很多人打了 tag 忘推CI 找不到5.8 Git-flow 工作流内置不用额外装团队用git-flow规范的main develop feature/* release/* hotfix/*Sourcetree 顶部Git-flow按钮一键初始化Git-flow→Initialize Repository→ 确认 mainmain, developdevelop开始功能Git-flow → Start New Feature→ 输名字 → 自动建feature/xxx并切过去完活Git-flow → Finish Feature→ 自动 merge 回 develop、删分支整套不用记git flow feature start/finish点就完事。5.9 回退与撤销两种完全不同的姿势你想…用等价命令刚才 commit 写错 message / 漏文件右上角Amend last commitgit commit --amend生成一条反向提交抵消掉某次不改历史安全右键提交 →Revert commitgit revert hash把分支指针硬挪到某提交改历史危险右键提交 →Reset current branch to this commit→ 选 Soft/Mixed/Hardgit reset --soft/mixed/hardSoft只挪 HEAD代码还在暂存区 → 适合揉几次提交成一次Mixed默认挪 HEAD代码在工作区但未暂存Hard连工作区一起扔 → 改没了慎用⚠️Reset --hard 已推送到远端的分支 灾难除非你确定队友没人基于那截提交干活否则优先用Revert。5.10 进阶功能清单老手专区Stash改了一半要切分支Stash按钮或右键工作区 →Stash changes回来再Apply Stash。等价于git stash。Cherry-pick右键某条提交在别的分支上的→Cherry pick把那次提交摘到当前分支不改历史只复制。Interactive Rebase右键一段连续提交 →Rebase children of hash interactively进 I-R 面板可以 squash揉扁、reword改 msg、drop扔掉、reorder重排。Sourcetree 4.x 这功能已经比早年稳很多。Submodule右键仓库根 →Add Submodule填子仓 URL 路径。更新时右键子模块 →Update Submodulegit submodule update --init --recursive。Git LFSSourcetree 开箱支持.lfsconfig配好就能跟踪*.psd/*.mp4之类大资产。本地提交搜索顶部搜索框不仅能搜 commit hash还能搜哪个提交改过package.json——大仓库查 bug 救命用。六、性能与个性化配置6.1 大仓库卡顿调优提交数过万、文件数过十万比如 monorepo时Sourcetree 容易转菊花。可调这几项工具 → 选项 → Git→ 勾Enable bisect / Enable rebase​ 之外的花哨功能酌情关工具 → 选项 → 一般→ 取消 Refresh automatically when files change改成手动 F5macOS 侧 4.2.8 有 Compact History 显示模式提交树更窄更省实在卡考虑把子目录拆成独立仓库 submodule或从 Sourcetree 切到 lazygit / GitKraken6.2 外部 Diff/Merge 工具配置路径工具 → 选项 → DiffWin或Sourcetree → Preferences → DiffMac常用组合Meld免费跨平台三窗格友好Beyond Compare付费但值得VS Code​ 也能当 diff 用code --diff left right配好后文件上右键External Diff直接呼出。6.3 快捷键记几个高频的快捷键Win / Mac动作CtrlEnter / CmdEnter提交CtrlP / CmdPPushCtrlShiftP / CmdShiftPPullCtrlB / CmdB新建分支F5刷新Ctrl3 / Cmd3切到搜索框七、常见问题 FAQQ1首次启动一定要登 Atlassian 账号吗A不用Skip跳过全部本地功能不受影响。绑账号只是为了一键 clone Bitbucket 私仓和 Jira 联动。Q2公司用 HTTPS 克隆每次都要输密码AWindows 侧装Git Credential Manager​ 会帮存Mac 侧用osxkeychain。或者干脆换成 SSH一劳永逸。Q3Sourcetree 里能看到文件但git status命令行看不到A多半是 Sourcetree 用的 Embedded Git 版本和你命令行 System Git 版本不一致.gitignore或core.autocrlf处理不同。统一成一种 Git 就好。Q4macOS 升级到 Sonoma/Sequoia 后 Sourcetree 闪退A4.2.6 已修 Sonoma 兼容性4.2.9 修了 Sequoia 运行问题升到最新就行。Q5中文文件名在文件列表变成\344\275...A没设core.quotepath false回去翻 4.4 节。Q6Push 时报 non-fast-forward 被拒A别人抢先推了先Pull或Fetch Rebase把别人的合进来再 Push如果确定要覆盖远端比如自己 feature 分支重整过 commit再开 force-with-lease。八、总结Sourcetree 的定位很清楚——它是 Git 的驾驶舱而不是替代品。底层还是 Git所有命令行能做的事它都能做且把分支图、部分暂存、交互式 rebase、git-flow这些新手不敢碰、老人天天用的动作包成了点按钮。对 Atlassian 生态Bitbucket Jira团队尤其顺免费 跨 Win/Mac 也让它成了国内很多公司的入职标配工具。但也别神话它超大型仓库会卡、Linux 没原生版、Electron 壳启动不算快——这些边界场景心里有数工具选得才不纠结。 给新人的最短路径装 → Skip 账号 → Embedded Git → 配 user.name/email → Clone 第一个仓 → 改文件 → Stage → Commit → Push这一套跑通Sourcetree 80% 的日常就覆盖了。剩下 20%冲突、rebase、cherry-pick、submodule等真撞上了再翻本文对应小节。参考链接Sourcetree 官网SourcetreeappSourcetree Release NotesmacOS 4.2.x 系列掘金《SourceTree 安装与使用指南》https://juejin.cn/post/7491706202193362955CSDN《Sourcetree 使用教程Git 图形化界面终极指南》社区支持: Atlassian Community社区支持: SourceTree安装与使用社区支持: SourceTree使用方法社区支持: scourcetree的安装和条过注册