企业官网建设流程全解析

https://www.sourcetreeapp.com/

Fork - a fast and friendly git client for Mac and Windows

ProcessOn - 我的文件

目录

• 一、SourceTree（Mac 版）使用教程

• 二、SourceTree（Windows 版）使用教程

• 附录：SourceTree vs Fork 速选

一、SourceTree（Mac 版）使用教程

1.1 SourceTree 是什么

Atlassian 出品的免费 Git 图形客户端，同时支持Mac 和 Windows，也支持 Mercurial（Hg）。

核心能力

1.2 下载与安装

1. 打开 https://www.sourcetreeapp.com/

2. 点击Download for Mac（当前Sourcetree_4.2.19左右）

3. 双击.dmg，把 SourceTree 拖进「应用程序」

4. 首次打开若被 Gatekeeper 拦截，去系统设置 → 隐私与安全性 → 仍要打开

⚠️国内下载慢是很常见的问题（Atlassian CDN 不稳定），可以换网络环境或使用国内镜像（如sourcetree.ijinshan.com）。

1.3 首次启动：账号与配置（最容易卡住的一步）

① 必须登录 Atlassian 账号

SourceTree强制要求登录 Atlassian 账号才能完成安装流程（有 Bitbucket 账号的直接用，同一套账号体系）。登录后凭据会持久化，之后不用重复登录。

• 注册页加载不出来 →换网络环境再试（Atlassian 的 CDN 在国内经常不稳定），这是最高频的卡点

• 完全不想用 Bitbucket 也没关系：登录只是为了过安装流程，之后可以完全只用 GitHub / GitLab / 本地仓库

② 选择版本控制工具

③ 配置用户信息（写入全局 git config）

git config --global user.name "Your Name" git config --global user.email "your.email@example.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…→ 粘贴仓库 URL（HTTPS 或 SSH）→ 选择本地目录 → Clone

• 添加已有本地仓库：File → Open…选择文件夹，或把文件夹拖到 SourceTree 图标上

• 也可以在远程仓库管理器里搜索并克隆GitHub / GitLab / Bitbucket 的仓库

• 加过的仓库会进Bookmarks，之后点一下即进

② 拉取与推送

③ 提交改动（最常用）

1. 进入仓库后，未提交的改动会显示在File Status / 工作区视图

2. 暂存：

   • 勾选整个文件 → 全量暂存

   • 或在 Diff 视图里选中某几行 →Stage Selected Lines（按行暂存）

   • 或按 hunk 暂存

3. 在下方输入Commit Message

4. 点Commit

   • 想合并到上一次提交 → 勾选Amend last commit

💡 SourceTree 的一大优势就是按行 / 按块暂存，review AI 生成的代码时特别有用——只挑要的几行进去。

④ 分支操作

合并示例：把feature/xxx合进develop

1. 双击切到develop

2. 工具栏点Merge→ 选择feature/xxx→ OK

3. 有冲突则进入冲突解决流程

⑤ 解决冲突

1. 冲突文件会显示为Conflicted状态

2. 点Resolve Conflicts→ 打开Merge Tool，逐块选择：

   • Mine（我方）/Theirs（对方）/ 手动编辑

3. 全部解决后标记为Resolved

4. 回到工作区Commit（合并场景）或点Continue（Rebase 场景）

⑥ 高级功能入口

1.6 Mac 版配置建议

• Preferences → General：默认克隆目录、是否自动获取（Auto-fetch）

• Preferences → Git：Git 版本、SSH Client、用户名邮箱

• Preferences → Diff：外部 Diff 工具、忽略空白字符

• 建议关掉不必要的「自动获取」频率，避免大仓库频繁 IO

二、SourceTree（Windows 版）使用教程

Windows 版功能与 Mac 版基本一致，主要差异在安装方式、界面布局和快捷键。下面只讲差异和 Windows 专属注意点。

2.1 下载与安装

1. 打开 Sourcetreeapp

2. 点击Download for Windows（当前SourceTreeSetup-3.4.32.exe）

3. 双击.exe，按向导一步步 Next

4. 若被SmartScreen拦截（提示"未知发布者"）→ 点「更多信息 → 仍要运行」

系统要求

企业环境可用Sourcetree for Windows Enterprise，支持批量安装、更新与集中管理。

2.2 首次启动：账号与配置

① 同样必须登录 Atlassian 账号（与 Mac 版同一套流程）。注册页打不开就换网络重试。

② 安装向导里的关键选择

③ 用户信息

git config --global user.name "Your Name" git config --global user.email "your.email@example.com"

或直接在 SourceTree 里工具 → 选项 → Git填写。

④ SSH 密钥

Windows 下默认读取%USERPROFILE%\.ssh。注意两点：

• Preferences → Git → SSH Client选OpenSSH（不要选 PuTTY/Plink，除非你用的是.ppk格式）

• 如果用 PuTTY 的.ppk密钥，需要先用 PuTTYgen 转换，或改用 OpenSSH 格式

2.3 与 Mac 版的操作差异

2.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：

* text=auto eol=lf

③ 路径过长报错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」组合的一部分，选一个顺手的就行：