Close

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

开始之前,您需拥有一个 Bitbucket Cloud 帐户以便按照本教程自行操作。本指南将为您介绍 Bitbucket 的常用功能,因此您还需安装 Git,熟悉一些基本的 Git 命令以及 Git 的工作原理。

第一次使用 Git?不用担心,我们会帮助您克服所有困难。阅读我们的《正确使用 Git》教程,快速掌握 Git


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

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

存储库(商业上又称“代码存储库”)是 Bitbucket 中存储代码的位置。根据您的需求,可通过以下几种方法使用存储库:

新建空存储库

  1. 单击左侧全局边栏中的 +,然后在 Create new(新建)项下选择 Repository(存储库)
  2. 命名存储库。这一步很重要!存储库的名称将显示在其 URL 中。
  3. 将 Include a README?(是否添加自述文件?)选项设为 Yes(是),并提供模板
  4. 其余设置可保持默认值,然后单击 Create(创建)
新建存储库

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

  1. 单击左侧全局边栏中的 +,然后在 Import(导入)项下选择 Repository(存储库)
  2. 提供可访问存储库的 URL

  3. 如果您的存储库需要授权,则请勾选 Requires Authorization(需要授权)并提供访问凭据。

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

  5. 其余设置可保持默认值,然后单击 Import repository(导入存储库)

新建存储库

第 2 步:本地设置,全球协作

鉴于您的存储库位于云端,现在您需要设置本地系统以提供代码或更改 Bitbucket 中的代码。此步骤要求您已安装并配置 Git。如果您之前跳过了此步骤,则需返回并立即完成此部分内容。为协助您顺利操作,我们还单独制定了一份完整指南

克隆 Bitbucket 存储库

创建(或导入)后,要协同更改 Bitbucket 存储库中的密码,您首先需要将存储库克隆至本地系统。详细了解 Git 克隆

  1. 单击左侧全局边栏中的 +,然后在 Get to work(开始工作)项下选择 Clone this repository(克隆此存储库)
  2. 选择右上方菜单中的 HTTPS(除非已设置 SSH 密钥)。
  3. 复制克隆命令。
克隆此存储库

在 CLI 中

  1. 切换至您要克隆存储库的目录。cd
  1. 粘贴从 Bitbucket 复制的命令,类似于:git clone https://username@bitbucket.org/teamsinspace/documentation-test.git

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

在线更改 Bitbucket 中的文件

在开发人员日常工作期间,您将在本地处理代码,并在完成后保存更改。您通常可从命令行界面添加、提交和推送更改,且最高可推送至 Bitbucket。详细了解 Git 推送

假设您的同事对您之前推送的文件进行了重大更改。要完成更改,请转到 Bitbucket 中的存储库,然后单击以进入您所推送的某一文件。完成这些操作后,对应存储库中应会出现一个 README 文件(自述文件)。

要在线编辑此文件:

  1. 转到存储库
  2. 单击文件名
  3. 单击 Edit(编辑)
  4. 进行更改
  5. 单击 Commit(提交)。

此时,便可将针对 Bitbucket 的更改拉取到您的本地系统。

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

您是否跳过了将 README(自述)文件添加至 Bitbucket 存储库的可选步骤?没关系!如果存储库仍然为空,请转到存储库,单击 Create a README(创建自述文件)以立即创建一个自述文件。随后存储库便已包含内容,从而可进行克隆操作。

从 Bitbucket 拉取更新

您在协同处理代码时,经常需要获取团队成员所做的更改,以便更新您的本地存储库。此操作可确保您使用的始终是最新版代码。详细了解 Git 拉取

在 CLI 中

  1. 切换至您要克隆存储库的目录。cd
  1. 粘贴从 Bitbucket 复制的命令,类似于:git clone

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

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

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

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

创建分支

  1. 在存储库中,单击全局边栏中的 +,然后在 Get to work(开始工作)项下选择 Create a branch(创建分支)
  2. 如果您使用的是 Branching model(分支模型),则在弹出窗口中选择 Type(类型),输入 Banch name(分支名称),然后单击 Create(创建)
创建分支

在 CLI 中

  1. 创建完成后,从本地系统获取内容并签出分支。Bitbucket 将自动向您显示所需命令,类似于:git fetch && git checkout <分支名称>
  2. 在本地进行更改,然后添加、提交和推送所做更改至分支:git add.git commit -m "adding a change from the feature branch" git push origin <分支名称>
  3. 单击存储库的 Source(来源)页面。此时,下拉列表中既会显示 master(主分支),还会显示分支。
筛选分支

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

  1. 使用 Git 分支命令创建分支。git branch <分支名称>
  2. 列出此存储库的分支。您会看到默认主分支和您创建的新分支。git branch
  3. 签出分支。git checkout <分支名称>

  4. 将新分支推送至 Bitbucket。git push --set-upstream origin <分支名称>

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

  1. 转到您的存储库。

  2. 单击 Branches(分支)

筛选分支

此操作要求您拥有 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,以便快速分享特定评论。

批准或拒绝拉取请求
审查完代码更改后,您需要告知拉取请求的作者是否可以合并其拉取请求。单击 Approve(批准)按钮向拉取请求的作者发送通知,并表明您认为所做更改可以安全合并。如果您拒绝拉取请求,则情况相反。被拒绝的拉取请求将无法再打开。要合并对应分支,您必须新建一个拉取请求。

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

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


指南 2 第 1 部分:了解界面

指南 1:Bitbucket 简要概述