• 首页
  • 博客
  • 项目
  • 留言墙
  • AMA 咨询

动态更新

喜欢我的内容的话不妨订阅支持一下 🫶
加入其他 0 位订阅者,每月一封,随时可以取消订阅。

© 2025 Stiles Castle. 网站已开源:GitHub

首页博客项目留言墙AMA 咨询
总浏览量 1.3万最近访客来自 Ashburn, US🇺🇸
  • 一:代码审查中的角色
  • 二:审查流程
  • 三:案例演示
  • 发起评论
  • 取消消息推送
  • 通过审查
  • 发起修订
  • 完成审查
  • 关闭审查
  • 审核状态
  • 四:其它实践
Upsource实践指南
2022/05/10软件工程

Upsource实践指南

Upsource是一款由Jetbrains公司出品的代码审查工具,具有社交属性,将代码予以团队成员或其他人分享,讨论。浏览代码视觉效果美观,可以与IDEA无缝集成,完成代码审查工作。

58次点击22分钟阅读

官方文档:点击查看

一:代码审查中的角色

在 Upsource 中,典型的代码审查过程涉及两个或多个参与者,可分为以下角色:

  • Author 是一个提交者,代码审查即是来检查他/她所提交的更改。
  • Reviewer 应检查作者提交的更改并留下反馈。他还可以完成审查、提出对更改的关注,也可以关闭这次审查。
  • Watcher 预计不会参与审核过程。不太需要去关心代码的细节修改,关注重点是项目的状态以及团队成员的讨论。

如何邀请别人审查代码,作为Review的发起者,你可以点击左侧Overview 模块下对应的+符号, 邀请团队成员或者其他人作为reviewer或者watcher,同时,你可以将鼠标悬停在头像之上,看到该成员本次review的进度,如下所示

二:审查流程

代码的修改者一般作为审查流程的发起者,如果要邀请团队成员其他成员进行代码审查,需要进行以下操作:

  • 将更改内容提交到版本管理系统(Gitlab/Github)。
  • 创建一个审查流程(可以设置为系统自动发起)。
  • 邀请审查参与者(Reviewer和可选的Watcher)。
  • 讨论代码的问题,审查流程参与者交换意见。
  • Author解决问题,提交版本修订,并将新的修订添加到现有的评审中。(IDEA的Upsource插件支持自动添加)
  • 当Reviewer接受你的修改后,便可以关闭审查流程。

以下详细讲解如何创建Upsource代码审查。

三:案例演示

发起评论

创建了2个developer角色的账号,developer1和developer2.

使用developer1账号进行评论,点击红色的铅笔icon进行评论,在评论框中可以使用@符号来通知到对应的开发人员。

如下所示发送了:@developer2 是否有添加单元测试?

切换到developer2账号,点击review视图,可以查看到对应的的评论信息,如下图

点击#符号可以跳转到具体评论位置,进行回复

developer1评论发起者可以通过点击右侧的resolve按钮表示处理已解决,

也可以点击添加对应标签,标注这个问题是功能性的BUG还是代码的样式问题等。也可以自定义标签在全局项目中使用。

取消消息推送

如果想停止对评论的监视,停止接收消息通知,可以从观察者列表中删除你自己。

如果不想删除自己,可以设置为Mute review(消息免打扰),这样这个评审后续的讨论信息就不会出现在你的News Feed中了。不过链接到评审中还是可以看到的。

通过审查

如果你对作者的修改感到满意,那你就可以点击Accept。如果你觉得这些问题值得怀疑,那就点击Raise concern

如果最初提交的修订没有得到Reviewer的Accept,可以按照Reviewer的要求处理这些问题并提交代码的修订到gitlab,然后可以将一个或几个新的修订附加到原始审核中以获得Accept。

发起修订

使用idea提交代码的时候可以勾选Amend(修订),勾选review with upsource选择对应的审查记录。完成一次修订提交。

完成审查

当达到所有审查者的要求后,审查者都Accept/raise concern这个 Review的修改结果后,表示接受此次修订,此次审查被视为完成。

关闭审查

审查者和代码作者都可以关闭 Review,可以在项目属性设置中代码作者是否有关闭Review的权限。

审核状态

审查可以经历三个不同的阶段:

  1. 待定— 已创建审阅并分配审阅者。
  2. 已完成——所有审阅者通过接受(accept )或关注(raise concern)变更的时候。
  3. 已关闭— 由作者关闭,因为不需要或期望所有参与者采取进一步行动。

四:其它实践

upource允许自动添加工作流程,例如:可以通过添加对应触发器,自动添加对应的代码审查者

也可以通过webhook完成整个自动构建流程和消息通知等

比如通过upsource webhook 发送对应通知消息,或者触发对应jenkins任务。

相关文章

代码审查指南

2022/05/09软件工程8211分钟阅读

使用kubewatch监控k8s资源变更

2021/06/04软件工程3915分钟阅读

Liquibase简单介绍与使用

2021/04/05软件工程5315分钟阅读