了解 Bitbucket Cloud 的 Git

执行以下操作来创建您的存储库：

1. 在 Bitbucket 中，单击全局侧边栏中的 + 图标，然后选择存储库。

Bitbucket 将显示创建新的存储库页面。花一些时间查看对话框中的内容。除存储库类型外，您在此页面上输入的任何内容都可以在以后更改。

2. 在名称字段中输入 BitbucketStationLocations。Bitbucket 将在存储库的 URL 中使用此名称。例如，如果用户 the_best 有一个名为 awesome_repo 的存储库，该存储库的 URL 是 https://bitbucket.org/the_best/awesome_repo。

3. 对于访问级别保持这是一个私有存储库框处于选中状态。私有存储库只对您和具有访问权限的人可见。如果取消选中此框，每个人都可以看到您的存储库。

4. 选择 Git 作为存储库类型。请记住，单击创建存储库后无法变更存储库类型。

5. 单击创建存储库。Bitbucket 将创建您的存储库，并显示它的概述页面。

单击全局侧边栏中的 +，可以进行针对存储库的常见操作。单击导航侧边栏中的项目，查看每个项目背后的内容，包括用于更新存储库详细信息的设置和其他设置。要查看可用于浏览这些项目的快捷方式，请按键盘上的 ? 键。

当您单击侧边栏中的提交选项时，您会发现没有提交，因为您没有为存储库创建任何内容。您的存储库是私有的，并且您还没有邀请任何人访问该存储库，因此目前能够创建或编辑存储库内容的人只有您，您是该存储库的负责人。

随着您更多地使用 Bitbucket，您可能会用到多个存储库。因此，最好创建一个包含所有这些存储库的目录。

2. 创建一个目录来包含您的存储库。

3. 在终端中，将要使用的目录更新到新的代码存储库目录。

4. 在 Bitbucket 中，转到您的 BitbucketStationLocations 存储库。

5. 单击全局侧边栏中的 + 图标，然后选择克隆此存储库。

Bitbucket 显示一个弹出式克隆对话框。默认情况下，克隆对话框将协议设置为 HTTPS 或 SSH，具体取决于您的设置。就本教程而言，请勿变更您的默认协议。

6. 复制突出显示的克隆命令。

7. 在终端窗口中，粘贴从 Bitbucket 复制的命令，然后按返回。

8. 根据终端的要求输入您的 Bitbucket 密码。如果您通过链接到 Google 创建了帐户，请使用该帐户的密码。

• 如果您遇到 Windows 密码错误：
  • 在某些版本的 Microsoft Windows 操作系统和 Git 中，您可能会看到与以下示例类似的错误。
    
    Windows 克隆密码错误示例

• 如果出现此错误，请在命令行中输入以下内容：

• 然后返回步骤 4 并重复克隆流程。bash 代理现在应该提示您输入密码。您只需这样做一次即可。

此时，您的终端窗口应该如下所示：

• 您已经知道您的存储库是空的对吧？请记住，您尚未向其中添加任何源文件。

9. 列出您的代码存储库目录的内容，您应该会在里面看到自己的 bitbucketstationlocations 目录。

恭喜！您已将存储库克隆到本地系统。

2. 在终端窗口中输入以下行以创建包含内容的新文件。

如果命令行不返回任何内容，则表示您正确创建了文件！

3. 获取本地存储库的状态。通过 git status 命令，您可以知道自己的项目与 Bitbucket 存储库相比的进展情况。

此时，Git 知道您创建了一个新文件，您会看到如下所示的内容：

该文件未被跟踪，这意味着 Git 看到的文件不是先前提交的一部分。状态输出还显示了下一步：添加文件。

4. 让 Git 追踪您的新 locations.txt 文件（使用 git add 命令）。就像创建文件时一样，当您正确输入时，git add 不会返回任何内容。

git add 命令将工作目录中的变更移动到 Git 暂存区域。在将一组变更提交到正式历史记录之前，您可以在暂存区域准备一组变更的快照。

5. 检查文件状态。

现在您可以看到新文件已添加（暂存），准备就绪后可以提交。git status 命令显示工作目录和暂存快照的状态。

6. 发出带有提交消息的 git commit 命令，如下一行所示。-m 表示随后显示提交消息。

git commit 拍摄暂存快照并将其提交到项目历史记录中。与 git add 结合使用，此流程为所有 Git 用户定义了基本工作流程。

到目前为止，您所做的一切都在本地系统中，对您的 Bitbucket 存储库是不可见的，直到您推送这些变更为止。

• 进一步了解 Git 和远程存储库
  • Git 与远程存储库（在您的例子中，Bitbucket 是远程存储库）通信的能力是每个基于 Git 的协作工作流程的基础。
  • Git 的协作模式为每个开发人员提供自己的存储库副本，以及自己的本地历史记录和分支结构。用户通常需要共享一系列提交，而不是一个变更集。Git 允许您在存储库之间共享整个分支，而不是将工作副本中的变更集提交到中央存储库。

• 您可以管理与其他存储库的连接，并通过将分支“推送”到其他存储库来发布本地历史记录。您可以看到其他人通过将分支“拉”入您的本地存储库做了什么。

7. 回到您的本地终端窗口，使用 git push origin main 将您提交的变更发送到 Bitbucket。此命令指定您要推送到源头（Bitbucket 服务器）上的主分支（Bitbucket 上的分支）。

您应该会看到类似于以下响应的内容：

您的提交现在在远程存储库 (origin) 上。

8. 转到您在 Bitbucket 中的 BitbucketStationLocations 存储库。

9. 如果您单击侧边栏中的提交，您将看到您在存储库中的单个提交。Bitbucket 将您刚才的所有操作组合到该提交中并显示给您。可以看到，作者列显示了您在配置 Git 全局文件 (~/.gitconfig) 时使用的值。
如果您在侧边栏中单击“源”，则会看到您的存储库中只有一个源文件，即您刚刚添加的 locations.txt 文件。

还记得第一次创建存储库时的样子吗？现在看起来可能有点不一样了。

要添加您的新位置文件，请执行以下操作：

1. 在您的 BitbucketStationLocations 存储库中，单击源，打开源目录。注意，您的目录中只有一个文件 locations.txt。

A. “源”页面：单击此链接打开页面。
B. 分支选择：选择您要查看的分支。
C. 更多选项按钮：单击以打开包含更多选项（例如“添加文件”）的菜单。
D. 源文件区域：查看 Bitbucket 中的文件目录。

2. 在源页面中，单击右上角的更多选项按钮，然后从菜单中选择添加文件。只有您已经向存储库中添加了至少一个文件时，更多选项按钮才显示。

这时将打开用来创建新文件的页面，如下图所示。

A. 新文件的分支：如果您要向其他分支添加文件，更改此选项。B. 新文件区域：在这里为您的新文件添加内容。

3. 在文件名字段中输入 stationlocations。

4. 从语法模式列表中选择 HTML。

5. 将以下 HTML 代码添加到文本框中：

6. 单击提交。提交消息字段将显示消息：stationlocations created online with Bitbucket。

7. 单击消息字段下面的提交。

现在，您在 Bitbucket 中有一个新文件！您将看到包含提交详细信息的页面，在该页面中您可以看到您刚刚进行的变更：

如果您要查看目前为止已经做出的提交的列表，单击侧边栏中的提交。

现在我们需要把这个新文件放到您的本地存储库中。过程很简单，基本上就是让 locations.txt 文件进入 Bitbucket 的推送过程的反向过程。

要将文件拉取到本地存储库中，请执行以下操作：

1. 打开终端窗口，导航到本地存储库的顶层。

2. 输入 git pull--all 命令，从 Bitbucket 中提取所有变更。（在更复杂的分支工作流程中，拉取和合并所有变更可能不合适。）根据要求输入您的 Bitbucket 密码。您的终端应如下所示

git pull 命令使用单个命令将远程存储库 (Bitbucket) 中的文件合并到本地存储库中。

3. 导航到本地系统上的存储库文件夹，您将看到刚才添加的文件。

非常好！添加了关于空间站位置的两个文件后，您已经在 Bitbucket 和本地系统之间执行了基本的 Git 工作流程（克隆、添加、提交、推送和拉取）。

要创建分支，请执行以下操作：

1. 转到终端窗口，使用以下命令导航到本地存储库的顶层：

2. 从终端窗口创建分支。

这个命令会创建一个分支，但不会将您切换到那个分支，所以您的存储库看起来像这样：

存储库历史记录保持不变。您得到的只是一个指向当前分支的新指针。要开始开发新分支，您必须签出您想要使用的分支。

3. 签出您刚刚创建的新分支，开始使用。

git checkout命令与 git 分支齐头并进。因为您正在创建一个分支来处理新内容，所以每次您使用 git branch 创建一个新分支时，如果要使用，都要确保将其签出（使用 git checkout）。现在您已经签出了新分支，您的 Git 工作流程看起来像这样：

4. 在本地系统上搜索 bitbucketstationlocations 文件夹并将其打开。您会发现，由于有了新分支，目录中没有多余的文件或文件夹。

5. 使用文本编辑器打开 stationlocations 文件。

6. 通过添加其他站点位置对文件进行变更：

7. 保存并关闭该文件。

8. 在终端窗口中输入 git status。您应能看到类似下面这样的内容：

注意到 On branch future-plans 行了吗？如果您之前输入了 git status，则该行在主分支上，因为您只有一个主分支。在暂存或提交变更之前，请务必检查此行，以确保要添加变更的分支已签出。

9. 暂存您的文件。

10. 在终端窗口中输入 git commit 命令，如下所示：

有了最近的提交，您的存储库看起来像这样：

现在是时候将您刚才所做的变更合并回主分支了。

您的空间站正在成长，现在该是火星位置开幕式了。现在，您的未来计划已正在实现，您可以将未来计划分支合并到本地系统的主分支中。

由于您只创建了一个分支并做了一个变更，因此请使用快进分支方法进行合并。您可以进行快进合并，因为您有一条从当前分支尖端到目标分支的线性路径。不是“实际上”合并分支，Git 要整合历史记录，所要做的就是将当前分支的尖端向上移动（即“快进”）到目标分支的尖端。这有效地合并了历史记录，因为所有可从目标分支访问的提交现在都可以通过当前分支获得。

这种分支工作流程对于变更较小的短期主题分支很常见，而对于运行时间较长的功能则不常见。

要完成快进合并，请执行以下操作：

1. 转到终端窗口，导航到本地存储库的顶层。

2. 输入 git status 命令以确保您已提交所有变更，并找出您签出了哪个分支。

3. 切换到主分支。

4. 将未来计划分支的变更合并到主分支中。它会类似于下方的内容：

您基本上已经将主分支的指针向前移动到了当前分支的头部，您的存储库看起来就像上面的快进合并。

5. 因为您不打算再使用未来计划，所以您可以删除分支。

当您删除未来计划时，您仍然可以使用提交 ID 从主分支访问该分支。例如，如果您想撤销从未来计划中添加的变更，请使用刚才收到的提交 ID 返回该分支。

6. 输入 git status 以查看合并结果，该结果显示您的本地存储库比远程存储库领先一个。它会类似于下方的内容：

以下是您到目前为止所做的事情：

• 创建了一个分支并签出
• 在新分支中进行了变更
• 已将变更提交到新分支
• 将变更集成回主分支中
• 删除了您不再使用的分支。

接下来，我们需要将所有这些工作推送回您的远程存储库 Bitbucket。

以下是将变更推送到远程存储库的方法：

1. 在终端窗口的存储库目录中，输入 git push origin main 来推送变更。它会类似于下方的内容：

2. 单击 Bitbucket 存储库的概览页面，您会看到您的推送显示在最近的活动信息流中。

3. 单击提交，您可以看到本地系统中的该项提交。请注意，该变更具有与您本地系统上相同的提交 ID。

您还可以看到，提交列表左边的那一行有一条直接的路径，没有显示任何分支。这是因为未来计划分支从未与远程存储库交互，只与我们创建和提交的变更进行过交互。

4. 单击分支，注意该页面也没有该分支的记录。

5. 单击源，然后单击 stationlocations 文件。您可以看到文件最后的变更具有您刚刚推送的提交 ID。

6. 单击文件历史记录列表查看为此文件提交的变更，类似下图所示。