https://www.sourcetreeapp.com/Fork - a fast and friendly git client for Mac and WindowsProcessOn - 我的文件目录一、SourceTreeMac 版使用教程二、SourceTreeWindows 版使用教程附录SourceTree vs Fork 速选一、SourceTreeMac 版使用教程1.1 SourceTree 是什么Atlassian 出品的免费 Git 图形客户端同时支持Mac 和 Windows也支持 MercurialHg。项目说明开发商AtlassianBitbucket 同门许可证完全免费个人 / 商用均可后端引擎Git主力 Mercurial可取消安装平台macOS / Windows官网https://www.sourcetreeapp.com/核心能力类别功能提交按文件 / hunk块/ 行三种粒度暂存与丢弃可视化分支 DAG 图一眼看出谁从谁分出、合并合没合干净、单点查看任意分支/提交高级操作交互式 Rebase、Cherry-pick、Stash、Revert、软/硬 Reset、Tag协作远程仓库管理器搜索 克隆、本地提交搜索扩展Git LFS、Git-Flow 开箱即用、Submodules1.2 下载与安装打开 https://www.sourcetreeapp.com/点击Download for Mac当前Sourcetree_4.2.19左右双击.dmg把 SourceTree 拖进「应用程序」首次打开若被 Gatekeeper 拦截去系统设置 → 隐私与安全性 → 仍要打开⚠️国内下载慢是很常见的问题Atlassian CDN 不稳定可以换网络环境或使用国内镜像如sourcetree.ijinshan.com。1.3 首次启动账号与配置最容易卡住的一步① 必须登录 Atlassian 账号SourceTree强制要求登录 Atlassian 账号才能完成安装流程有 Bitbucket 账号的直接用同一套账号体系。登录后凭据会持久化之后不用重复登录。注册页加载不出来 →换网络环境再试Atlassian 的 CDN 在国内经常不稳定这是最高频的卡点完全不想用 Bitbucket 也没关系登录只是为了过安装流程之后可以完全只用 GitHub / GitLab / 本地仓库② 选择版本控制工具选项推荐原因Version Control Tools只勾 Git取消 MercurialHg 在国内基本用不上Git 版本使用系统已安装的 GitSourceTree 内嵌的 Git 版本更新慢容易落后终端Windows 选 Git Bash / PowerShellMac 选默认方便唤起命令行③ 配置用户信息写入全局 git configgit config --global user.name Your Name git config --global user.email your.emailexample.com也可以在 SourceTree 的Preferences → Git里填写。④ SSH 密钥重要SourceTree默认不会自动识别~/.ssh下的 SSH 密钥。如果要用 SSH 协议的仓库需要手动指定Preferences → Git → SSH Client选择OpenSSH并指定私钥路径~/.ssh/id_rsa或id_ed25519图省事的话直接用 HTTPS 凭据管理器也可以。1.4 界面结构左侧栏仓库书签Bookmarks、分支列表、标签Tags、远程Remotes、Stashes、子模块中间区提交历史 DAG 图 提交列表底部/右侧选中提交或工作区文件的变更详情文件列表 逐行 Diff顶部工具栏Fetch/Pull/Push/Branch/Merge/Stash/Terminal/Git-flow等按钮操作入口有三个① 顶部工具栏按钮 ② 右键上下文菜单 ③ 菜单栏Mac 在屏幕顶部。日常操作建议优先用右键菜单最贴合当前上下文。1.5 日常操作流程① 克隆 / 添加仓库克隆File → New / Clone…→ 粘贴仓库 URLHTTPS 或 SSH→ 选择本地目录 → Clone添加已有本地仓库File → Open…选择文件夹或把文件夹拖到 SourceTree 图标上也可以在远程仓库管理器里搜索并克隆GitHub / GitLab / Bitbucket 的仓库加过的仓库会进Bookmarks之后点一下即进② 拉取与推送操作位置说明Fetch工具栏Fetch只拉远程更新不改本地代码Pull工具栏Pull拉取并合并到当前分支Push工具栏Push推送本地提交到远程③ 提交改动最常用进入仓库后未提交的改动会显示在File Status / 工作区视图暂存勾选整个文件 → 全量暂存或在 Diff 视图里选中某几行 →Stage Selected Lines按行暂存或按 hunk 暂存在下方输入Commit Message点Commit想合并到上一次提交 → 勾选Amend last commit SourceTree 的一大优势就是按行 / 按块暂存review AI 生成的代码时特别有用——只挑要的几行进去。④ 分支操作想做的事操作切换分支左侧分支列表双击分支名新建分支工具栏Branch或在某个提交上右键 →Branch…合并分支先切到目标分支 → 工具栏Merge→ 选源分支删除分支右键分支 →Delete拉取远程分支在 Remotes 下右键远程分支 →Checkout合并示例把feature/xxx合进develop双击切到develop工具栏点Merge→ 选择feature/xxx→ OK有冲突则进入冲突解决流程⑤ 解决冲突冲突文件会显示为Conflicted状态点Resolve Conflicts→ 打开Merge Tool逐块选择Mine我方/Theirs对方/ 手动编辑全部解决后标记为Resolved回到工作区Commit合并场景或点ContinueRebase 场景⑥ 高级功能入口功能怎么用用途交互式 Rebase提交上右键 →Rebase children of … interactivelysquash / 重排 / 编辑历史Cherry-pick提交右键 →Cherry Pick把某提交摘到当前分支Revert提交右键 →Reverse Commit反向抵消某次提交Reset提交右键 →Reset branch to this commit软/混合/硬重置硬重置会丢改动慎用Stash工具栏Stash临时收起未提交改动Tag提交右键 →Tag打标签Git-Flow工具栏Git-flow规范化 feature / release / hotfix 流程Git LFSPreferences 中启用大文件管理本地搜索右上角搜索框搜提交、文件变更、分支1.6 Mac 版配置建议Preferences → General默认克隆目录、是否自动获取Auto-fetchPreferences → GitGit 版本、SSH Client、用户名邮箱Preferences → Diff外部 Diff 工具、忽略空白字符建议关掉不必要的「自动获取」频率避免大仓库频繁 IO二、SourceTreeWindows 版使用教程Windows 版功能与 Mac 版基本一致主要差异在安装方式、界面布局和快捷键。下面只讲差异和 Windows 专属注意点。2.1 下载与安装打开 Sourcetreeapp点击Download for Windows当前SourceTreeSetup-3.4.32.exe双击.exe按向导一步步 Next若被SmartScreen拦截提示未知发布者→ 点「更多信息 → 仍要运行」系统要求项目要求操作系统Windows 10 / 1164-bit运行环境.NET Framework安装包会提示缺了要装Git可不预装 —— 安装程序会附带 Git内存 / 磁盘2 GB 内存起建议 4 GB/ 约 200 MB企业环境可用Sourcetree for Windows Enterprise支持批量安装、更新与集中管理。2.2 首次启动账号与配置① 同样必须登录 Atlassian 账号与 Mac 版同一套流程。注册页打不开就换网络重试。② 安装向导里的关键选择步骤推荐选择版本控制工具只勾 Git取消 Mercurial选择 Git 版本Use System Git用系统已装的 Git没装则让 SourceTree 装内嵌版终端推荐Git Bash或PowerShell③ 用户信息git config --global user.name Your Name git config --global user.email your.emailexample.com或直接在 SourceTree 里工具 → 选项 → Git填写。④ SSH 密钥Windows 下默认读取%USERPROFILE%\.ssh。注意两点Preferences → Git → SSH Client选OpenSSH不要选 PuTTY/Plink除非你用的是.ppk格式如果用 PuTTY 的.ppk密钥需要先用 PuTTYgen 转换或改用 OpenSSH 格式2.3 与 Mac 版的操作差异项目Mac 版Windows 版修饰键⌘ CommandCtrl菜单位置屏幕顶部系统菜单栏窗口内菜单栏工具 / 视图 / 仓库…偏好设置入口SourceTree → Preferences工具 → 选项配置文件目录~/.gitconfig%USERPROFILE%\.gitconfig版本号体系4.x3.x两版号不同步属正常界面技术原生 Cocoa.NET / WPF2.4 日常操作与 Mac 版相同克隆文件 → 新建/克隆→ 粘贴 URL → 选目录提交工作区勾选文件 → 可按行/按块暂存→ 填 message → 提交分支双击切换 / 工具栏新建 / 工具栏合并/ 右键删除拉取推送工具栏获取(Fetch)/拉取(Pull)/推送(Push)冲突解决冲突→ Merge Tool 里选 Mine / Theirs 或手动改 → 标记已解决 → 提交高级交互式变基、Cherry-pick、反向提交、Stash、Tag、Git-flow 入口同 Mac 版2.5 Windows 常见问题① 安装时提示缺少 .NET Framework去微软官网装 .NET Framework 4.7.2 或更高版本或让 Windows Update 自动安装。装完重新运行安装程序。② 换行符CRLF / LF导致整文件 diff 或警告Windows 用 CRLF、Mac/Linux 用 LF 导致的。推荐git config --global core.autocrlf true更推荐的做法是在仓库里加.gitattributes* textauto eollf③ 路径过长报错Windows 默认路径上限 260 字符git config --global core.longpaths true同时可在组策略中启用「启用 Win32 长路径」。④ 中文文件名显示成八进制乱码git config --global core.quotepath false⑤ 登录页打不开 / 卡在白屏Atlassian 的 CDN 在国内不稳定 → 换网络如手机热点后重试通常一次就能过。⑥ 大仓库卡顿SourceTree 在超大仓库上确实偏慢可关闭自动获取、减少显示的提交数量或改用命令行做重度操作。附录SourceTree vs Fork 速选两份工具都是「Git GUI CC Switch」组合的一部分选一个顺手的就行维度SourceTreeFork价格完全免费$59.99可免费试用平台Mac WindowsMac Windows启动/流畅度一般大仓库偏卡快、轻登录要求强制 Atlassian 账号无需注册按行/块暂存✅✅交互式 Rebase✅✅界面观感信息密度高、偏工程清爽现代适合不想花钱、习惯 Atlassian 生态追求速度和体验