利用 Bitbucket 改良代码：4 个起始步骤

现在，向您的存储桶中存入一些内容。

第 1 步：将您的代码放入 Bitbucket

存储库（在行业内常被亲切地称为“代码存储库”）是代码在 Bitbucket 中的存储位置。根据您的需求，可通过以下几种方法使用存储库：

从头开始

新建空存储库

  1. 点击左侧全局侧边栏中的 +，然后在“新建”项下选择存储库。

  2. 命名存储库。这一步很重要！存储库的名称将显示在其 URL 中。

  3. 将“是否包含自述文件？”选项设为是，使用模板。

  4. 其余设置可保持默认值，然后点击创建。

新建存储库

借助其他提供程序开始

通过其他 Git 提供商导入存储库

  1. 点击左侧全局侧边栏中的 +，然后在“导入”项下选择存储库。

  2. 提供可访问存储库的 URL。

  3. 如果您的存储库需要授权，请勾选需要授权并提供访问凭据。

  4. 命名存储库。这一步很重要！存储库的名称将显示在其 URL 中。

  5. 其余设置可保持默认值，然后点击导入存储库。

新建存储库

第 2 步：本地设置，全球协作

克隆 Bitbucket 存储库

  1. 点击左侧全局侧边栏中的 +，然后在“开始工作”项下选择克隆此存储库。

  2. 选择右上方菜单中的 HTTPS（除非已设置 SSH 密钥）。

  3. 复制克隆命令。

克隆此存储库

在 CLI 中

  • 切换到您想要克隆存储库的目录。cd

  • 粘贴从 Bitbucket 复制的 git clone 命令（格式类似如下）：git clone https://username@bitbucket.org/teamsinspace/documentation-test.git

此时，您的本地驱动器上会出现一个与您所克隆的存储库同名的子目录。如果您克隆的是一个空存储库，则该本地驱动器中的对应子目录也为空。

在线更改 Bitbucket 中的文件

稍等，我在 Bitbucket 中还没有文件…

您是否跳过了向 Bitbucket 存储库添加自述文件的可选步骤？没关系！如果存储库仍然为空，请转至存储库，点击创建自述文件以立即创建一个自述文件。现在您就有可克隆的内容，而不再是空存储库。

从 Bitbucket 拉取更新

在 CLI 中

  1. 切换到您想要克隆存储库的目录。cd

  2. 粘贴从 Bitbucket 复制的命令，类似于：git clone

此时，对这些文件所做的全部更改便已下载到本地系统。

第 3 步：使用 Bitbucket 进行基本分支

分支功能支持各团队成员同时处理不同事务，而不影响原始代码库或彼此的工作。准备好合并所做更改后，您需要将分支推送到 Bitbucket 以便在拉取请求中审查。

创建分支的方法众多，请选择最符合您团队需求的方法。

创建分支

从 Bitbucket（最简单）

  1. 在存储库中，点击全局侧边栏中的 +，然后在开始工作项下选择创建分支。

  2. 从显示的弹出窗口中选择类型（如果您使用分支模型），输入分支名称，然后点击创建。

创建分支

在 CLI 中

  1. 创建完成后，执行 git fetch 命令，然后从本地系统中检出该分支。Bitbucket 将自动向您显示所需命令，格式类似如下：git fetch && git checkout

  2. 在本地执行变更，然后添加、提交和推送所做变更至分支：

    git add.

    git commit -m "adding a change from the feature branch"git push origin

  3. 点击存储库的“源”页面。您应该会在下拉菜单中看到 main和分支

筛选分支

从 CLI

在本地存储库目录内的 CLI 中

  1. 使用 Git 分支命令创建分支。

  2. 列出此存储库的分支。您会看到默认 main（主）分支和您创建的新分支。

  3. 检出该分支。

  4. 将新分支推送至 Bitbucket。

现在，转到 Bitbucket 以查看分支。

  1. 转到您的存储库。

  2. 点击分支。

筛选分支

从 Jira

此操作要求您拥有 Jira Software Cloud 的访问权限，并且已将其集成至 Bitbucket。您需要管理员权限才能执行此操作，但如果您只想试用一下该集成以了解其工作原理，则可随时注册免费试用 Jira Software Cloud。

请阅读将 Bitbucket Cloud 连接至 Jira Software Cloud，了解在设置 Jira 站点后如何集成这两个产品的相关说明。

第 4 步：通过拉取请求审查代码更改

将代码更改推送至 Bitbucket 后，便可由同事审查这些更改。拉取请求简单有效，非常适用于审查代码以及共享环境中的团队协作。

创建拉取请求

  1. 在打开的存储库中，单击全局侧边栏中的 +，然后在“开始工作”下选择“创建拉取请求”。

  2. 填写拉取请求表中的其余内容：

创建拉取请求

  1. 源：您进行要合并的代码变更的存储库和分支。

  2. 目标：您希望将变更合并至的存储库和分支。

  3. 标题和描述：二者均会在电子邮件通知中显示，标题会展示在拉取请求列表内。

  4. 审查者：选择能够给出有效反馈且需要批准变更的审查者。

  5. 关闭分支：如果要在合并拉取请求后自动关闭分支，则选择此项。

  6. 差异与提交记录：查看这些选项卡以查看所做变更（差异）或所包含的提交记录。

  1. 单击 Create Pull Request（创建拉取请求）。

随后，此拉取请求便会显示在存储库侧面导航栏中的 Pull requests lists（拉取请求列表）中。

审查拉取请求

作为审查者，您会收到一条通知，告知您有拉取请求待审查。此外，您还可以从仪表板的拉取请求选项卡中找到打开的拉取请求。审查代码以保证质量的方法众多，但您的团队具体要怎么做完全由您决定。下面提供几种与同事进行有效沟通，以确保所有人都能理解所做变更，并批准待合并的变更。

查看差异：您在查看拉取请求时，会看到拉取请求中所有已变更文件的差异（即变更内容）。标有绿色阴影线的内容为新增内容，标有红色阴影线的内容则为已删除内容。您还可点击拉取请求顶部的“提交记录”选项卡，查看包含的提交记录，这对审查大型拉取请求很有帮助。

在评论中留下反馈并提出问题：在 Bitbucket 中，您可以针对整个拉取请求、特定文件，或是文件内的特定位置添加评论。当您希望反馈附带背景信息或具体细节时，该功能十分便捷。评论可包含图像、链接、富文本，并且拥有独立 URL，便于您快速分享特定评论。

批准或拒绝拉取请求：审查完代码变更后，您需要告知拉取请求的作者是否可以合并其拉取请求。点击“批准”可按钮向拉取请求的作者发送通知，并表明您认为所做变更可以安全合并。如果您拒绝拉取请求，则情况相反。被拒绝的拉取请求将无法重新打开。要合并该分支，您必须打开一个新拉取请求。

请注意，拒绝拉取请求会让作者感觉受挫，因此可能仅适用于偏离目标的更改，或不再需要的工作。记住在审查他人的工作时要心存善意，要在寻求对方的理解之前先去理解对方。

合并拉取请求：您的代码在拉取请求中完成审查并获得批准后，您可点击“合并”按钮将您的分支合并到主分支。此时，来自源分支的代码变更便会完整合并到目标分支中。