Atlassian SourceTree 入门：从克隆到提交的完整操作指南 – wiki大全

作者： /

Atlassian SourceTree 入门：从克隆到提交的完整操作指南

对于许多开发者来说，Git 是一个强大但令人生畏的工具。命令行操作虽然高效，但对于初学者而言，陡峭的学习曲线可能会成为障碍。幸运的是，Atlassian 开发的 SourceTree 提供了一个直观、免费的图形化界面，让 Windows 和 macOS 用户都能轻松地驾驭 Git 和 Mercurial。

本指南将带您从零开始，逐步掌握 SourceTree 的核心功能，覆盖从克隆现有项目到提交您自己的代码贡献的完整工作流程。

1. 什么是 SourceTree？为什么选择它？

SourceTree 是一个 Git GUI（图形用户界面）客户端，它将复杂的 Git 命令转化为简单的点击、拖拽和表单填写操作。

选择 SourceTree 的理由：

  • 可视化工作流：直观地查看分支、提交历史、合并情况，让您时刻清楚项目的结构和变更。
  • 简化操作：无论是暂存文件、解决合并冲突，还是执行 Cherry-pick（拣选提交）等高级操作，都变得异常简单。
  • 对初学者友好：无需记忆大量命令，是从命令行过渡或入门版本控制的最佳选择。
  • 功能强大：支持 Git-Flow 工作流、子模块、远程仓库管理等高级功能，满足专业开发者的需求。
  • 免费且跨平台：完全免费，并支持连接到任何远程 Git 仓库，如 GitHub, Bitbucket, GitLab 等。

2. 安装与初次配置

a. 下载与安装

访问 SourceTree 官方网站 下载适用于您操作系统的版本。安装过程非常直接，遵循向导提示即可。

b. 连接 Atlassian 账户

首次启动时，SourceTree 会建议您使用 Atlassian 账户登录。这有助于与 Bitbucket 等 Atlassian 产品无缝集成。如果您主要使用 GitHub 或其他服务，也可以选择跳过此步骤。

c. 配置用户信息

这是至关重要的一步。您的每一次提交都需要记录作者信息。

  1. 打开菜单栏的 工具 (Tools) > 选项 (Options)。
  2. 在 “默认用户信息” (Default User Information) 标签页中，填写您的 “全名” (Full Name) 和 “电子邮件地址” (Email Address)。
  3. 确保这里填写的邮箱与您在 GitHub/GitLab 等平台上的账户邮箱一致。

（这是一个示例图片链接，实际界面请以您的 SourceTree 版本为准）

3. 核心操作：克隆您的第一个仓库

“克隆” (Clone) 是将远程服务器上的项目代码完整复制到您本地计算机的过程。

  1. 打开克隆窗口：

    • 如果您是首次使用，欢迎界面会有一个醒目的 “Clone” 按钮。
    • 或者，点击主界面左上角的 + 新建 (“+ New”) > 从 URL 克隆 (Clone from URL)。

  2. 填写仓库信息：

    • 源 URL (Source URL)：这是您要克隆的仓库的地址。通常以 https:// 或 git@ 开头。您可以从 GitHub/GitLab 等仓库主页上轻松复制。
    • 目标路径 (Destination Path)：选择一个您本地电脑上的文件夹，用于存放克隆下来的项目代码。建议选择一个干净、易于管理的路径。
    • 名称 (Name)：这是该项目在 SourceTree 中显示的名称（书签），可以自定义。

  3. 点击“克隆” (Clone)：
    SourceTree 会开始下载仓库。如果仓库是私有的，系统可能会提示您输入用户名和密码或配置 SSH 密钥。

下载完成后，该仓库会自动出现在 SourceTree 的本地仓库列表中，双击即可打开。

4. 日常工作流：修改、暂存、提交与推送

这是您每天都会用到的核心循环。

a. 查看与修改文件

克隆完成后，您可以在您选择的 “目标路径” 中找到项目文件。使用您喜欢的代码编辑器（如 VS Code）对文件进行任意修改。

b. 暂存变更 (Stage)

完成修改后，返回 SourceTree 界面。您会看到主窗口的 “文件状态” (File Status) 区域列出了所有被修改过的文件。

  • 工作区文件 (Unstaged files)：这里显示了所有已修改但尚未准备提交的文件。
  • 暂存区文件 (Staged files)：这里是您希望包含在下一次提交中的“快照”。

如何暂存？

  • 暂存所有文件：勾选 “工作区文件” 顶部的 “全选” (Stage All) 复选框。
  • 暂存单个文件：勾選您想要暫存的特定文件旁邊的複選框。
  • 暂存部分内容 (Hunk)：SourceTree 最强大的功能之一！双击一个文件，您可以在右侧的差异视图中，选择只暂存文件中的某几行代码（一个 “Hunk” 或 “Line”），这对于创建逻辑清晰的、原子化的提交至关重要。

c. 提交变更 (Commit)

当您将所有需要的变更都移入 “暂存区” 后，就可以“提交”它们了。提交就像是为您的项目拍摄一张带有描述的照片。

  1. 检查暂存区：确保所有希望提交的修改都在 “暂存区文件” 列表中。
  2. 撰写提交信息 (Commit Message)：在暂存区下方的文本框中，输入清晰、有意义的提交信息。一个好的提交信息通常包括：
    • 第一行（标题）：简明扼要地概括本次提交的目的（如：feat: 添加用户登录功能）。
    • （可选）空一行
    • （可选）正文：更详细地描述修改的原因、实现方式等。
  3. 执行提交：点击右下角的 “提交” (Commit) 按钮。

提交后，您会看到左侧的 “历史” (History) 视图中出现了一个新的节点，代表您刚刚的提交。但请注意，此时这个提交仅存在于您的本地计算机上。

d. 推送至远程仓库 (Push)

为了让团队其他成员看到您的代码，或者为了在云端备份您的工作，您需要将本地提交 “推送” (Push) 到远程服务器。

  1. 点击工具栏上方的 “推送” (Push) 按钮。
  2. 在弹出的窗口中，选择您想要推送的本地分支（通常是您当前工作的分支）以及您希望推送到哪个远程分支。
  3. 勾选对应的分支，然后点击 “推送” (Push)。

推送成功后，您的代码就安全地上传到远程仓库了。

e. 拉取远程变更 (Pull)

当您的同事向远程仓库推送了新的提交后，您需要将这些变更同步到您的本地。

  1. 点击工具栏上方的 “拉取” (Pull) 按钮。
  2. 选择要从中拉取更新的远程分支。
  3. 点击 “确定” (OK)。

SourceTree 会自动从远程仓库下载最新的提交，并尝试将其与您的本地代码合并 (Merge)。如果出现冲突，SourceTree 会提示您并提供工具来解决它们。

5. 分支管理：并行工作的基石

分支是 Git 最强大的功能之一，它允许您在不影响主线（如 main 或 develop 分支）的情况下开发新功能或修复 Bug。

  • 创建分支：点击工具栏的 “分支” (Branch) 按钮，输入新分支的名称，即可从当前提交创建一个新分支。
  • 切换分支：在左侧的 “分支” (BRANCHES) 列表中，双击您想切换到的分支名称即可。
  • 合并分支 (Merge)：当您在新分支上的工作完成后，首先切换回目标分支（如 develop），然后右键点击您刚刚完成工作的分支，选择 “合并 [您的分支名] 到 current” (Merge [your-branch-name] into current)。
  • 查看分支图：“历史” 视图中的分支图会清晰地展示所有分支的创建、合并和提交历史。

总结

恭喜您！您已经掌握了使用 SourceTree 进行版本控制的整个核心流程。从克隆项目开始，到修改、暂存、提交，再到与团队同步的推送和拉取，这些构成了日常开发的基础。

我们鼓励您多加探索 SourceTree 的其他功能，例如 Stash (贮藏)、Git-Flow 和交互式变基 (Interactive Rebase)，它们将进一步提升您的工作效率。忘记命令的束缚，享受可视化版本控制带来的清晰与便捷吧！

滚动至顶部